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PREFACE 



The Network Operating System (NOS) was developed by Control Data Corporation to provide network 
capabilities for time-sharing and transaction processing, in addition to local and remote batch processing, 
on the CONTROL DATA® CYBER 170 Series; CDC® CYBER 70 Series, Models 71, 72, 73, and 74 
Computer Systems, and CDC 6000 Series Computer Systems. 



CONVENTIONS 

Extended memory for the CYBER 170 Model 176 is large central memory extended (LCME). Extended 
memory for all other NOS computer systems is extended core storage (ECS) or extended semiconductor 
memory (ESM). 

In this manual, the acronym ECS refers to all forms of extended memory unless otherwise noted. 
However, in the context of a multimainframe environment or distributive data path (DDP) access, model 
176 is excluded. 

Programming information for the various forms of extended memory can be found in the COMPASS 
Reference Manual and in the appropriate computer system hardware reference manual. Hardware 
descriptions of the various forms of extended memory can be found in the following manuals. 

Control Data Publication Publication Number 



Extended Semiconductor Memory Hardware Reference Manual 60455990 

Extended Core Storage Reference Manual 60347100 

Extended Core Storage n and Distributive Data Path Reference 

Manual 60430000 



AUDIENCE 

This manual contains information required by the site analyst or administrative personnel to perform the 
day-to-day maintenance activities required in a normal production environment of NOS. 



RELATED PUBLICATIONS 

The reader should be thoroughly familiar with the material in the following publications. 

Control Data Publication Publication Number 



Network Products 

Interactive Facility Version 1 Reference Manual 60455250 

or 

NOS Version 1 Time-Sharing User's Reference Manual 60435500 

NOS Version 1 Operator's Guide 60435600 

NOS Version 1 Reference Manual, Volume 1 60435400 
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The NOS Manual Abstracts is a pocket-sized manual containing brief descriptions of the contents and 
intended audience of all NOS and NOS product manuals. The abstracts can be useful in determining 
which manuals are of greatest interest to a particular user. 

Control Data also publishes a Software Publications Release History of all software manuals and revision 
packets it has issued. This history report lists the revision level of a particular manual that corresponds 
to the level of software installed at the site. 

The following publications provide additional information about NOS and its product set that may be 
useful to the reader. 



Control Data Publication 

COMPASS Version 3 Reference Manual 

CYBER Loader Version 1 Reference Manual 

CYBER Record Manager Advanced Access Methods Version 2 
Reference Manual 

CYBER Record Manager Basic Access Methods Version 1.5 
Reference Manual 

CYBER 70 Model 71 Computer System Reference Manual 

CYBER 70 Model 72 Computer System Reference Manual 

CYBER 70 Model 73 Computer System Reference Manual 

CYBER 70 Model 74 Computer System Reference Manual 

CYBER 170 Computer Systems Models 720, 730, 750, 760, and 
176 (Level B) Hardware Reference Manual 

CYBER 170 Computer Systems Reference Manual 

Export/Import Reference Manual 

FORTRAN Extended Version 4 Reference Manual 

FORTRAN Version 5 Reference Manual 

Modify Instant 

Modify Reference Manual 

Network Products 

Message Control System Version 1 Reference Manual 

Network Products 

Network Access Method Version 1 Reference Manual 

Network Products 

Network Access Method Version 1 

Network Definition Language Reference Manual 

Network Products 

Network Terminal User's Instant 



Publication Number 
60492600 
60429800 
60499300 

60495700 

60453300 
60347000 
60347200 
60347400 
60456100 

60420000 
60436200 
60497800 
60481300 
60450200 
60450100 

60480300 
60499500 

60480000 
60455270 



VI 
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Control Data Publication 



Publication Number 



Network Products 

Remote Batch Facility Version 1 Reference Manual 

Network Products 
Stimulator Reference Manual 

Network Products 

Transaction Facility Version 1 Reference Manual 

Network Products 

Transaction Facility Version 1 User's Guide 

NOS Version 1 Applications Programmer's Instant 

NOS Version 1 Batch User's Guide 

NOS Version 1 Diagnostic Index 

NOS Version 1 Installation Handbook 

NOS Version 1 Manual Abstracts 

NOS Version 1 Operator's Guide 

NOS Version 1 Reference Manual, Volume 2 

NOS Version 1 Systems Programmer's Instant 

NOS Version 1 Terminal User's Instant 

Software Publications Release History 

TAF/TS Version 1 Reference Manual 

TAF/TS Version 1 User's Guide 

Text Editor Reference Manual 

Update Reference Manual 

6400/6500/6600 Computer Systems Reference Manual 



60499600 

60480500 

80455340 

60455360 

60436000 
60436300 
60455720 
60435700 
84000420 
60435600 
60445300 
60449200 
60435800 
60481000 
60453000 
60436500 
60436100 
60449900 
60100000 



DISCLAIMER 

NOS and its product set are intended to be used only as described in this document. Control Data cannot 
be responsible for the proper functioning of undescribed features or parameters. 
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PERMANENT FILE UTILITIES 



Five utility processors maintain the NOS permanent file system. They control the dumping and loading 
of permanent files, the cataloging of permanent files in the system and on backup storage (archive) files, 
and the copying of archived files to a control point. 

The utility processors are overlays under the control of the permanent file supervisor (PFS). The PFS 
processes the parameters in the utility command and loads the correct processing overlay. The overlay 
interacts with the permanent file utility routine PFU, which manages the catalogs, permits, data 
allocation on a device, and the data transfer between device and overlay. Figure 1-1 is an overview of 
this procedure. 



The names and functions of the permanent file utilities follow. Detailed information about the call and 
operation of each utility is contained in the following sections. 



Utility 
PFATC 
PFCAT 

PFCOPY 
PFDUMP 

PFLOAD 



Description 

Produces a cataloged directory of file information derived from an archive file. 

Produces a cataloged directory of file information derived from catalog tracks 
on a permanent file device. 

Copies files from a backup storage file to a control point. 

Dumps files from a permanent file device to a backup storage file. Files created 
by this dump can be reloaded by the PFLOAD utility. 

Loads files from a backup storage file (created by PFDUMP) to a permanent file 
device. 



DEFINITIONS 

The descriptions of the permanent file utilities require some familiarity with the terms whose definitions 
follow. 



ARCHIVE FILE (TAPE) 

The permanent files accumulated on mass storage can be dumped as a whole or in part to a backup tape 
(or other type of backup medium) to protect the files from loss in case of a device malfunction or to free 
a device for temporary use during preventive maintenance. Each dump of permanent files is made to a 
file called an archive file; each permanent file dumped is called an archived file. Each archive file is a 
multirecord file in which each logical record is an archived file. If two or more archive files are created 
on one type of backup device, these archive files constitute a multifile archive file (figure 1-2). 

The archive file can be loaded back onto the permanent file system as a whole or in part and can also be 
used to generate reports. The individual archived files can be referenced for selective use. Refer to a 
particular utility for more information. 
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LOAD 




PFCAT 1 

OVERLAY FOR 

FOR DEVICE 

CATALOG 




PFATC1 

OVERLAY FOR 
ARCHIVE 
CATALOG 



PERMANENT FILE UTILITY (PFU) 
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COPY TO CP 




Figure 1-1. Functional Overview of the Permanent File Utility Overlays 
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USER INDEX 

A 17-bit user index is associated with each user number created on the VALIDUst file. This index is 
entered through MODVAL (refer to User Validation in section 5) with the UI identifier on the user 
number input directive (/usernum,FUI=userin) or MODVAL, by default, supplies the next available index. 

Whenever a user submits a job, the related user index is placed in the control point area along with the 
user number, job name, and other parameters that link hardware, files, and job. The permanent file 
manager (PFM) identifies the master device and catalog track for -this user by performing two masking 
operations which involve the user index and two sets of device parameters (device mask and number of 
catalog tracks) obtained from the mass storage table in CMR. One operation correlates the rightmost 
octal digit in the user index (bits through 2) with the bit settings of the device mask for each device in 
the configuration to determine which device is the user's master device (refer to the device mask 
definition). The other operation performs a logical AND between the remaining portion of the index and 
the number of catalog tracks on the master device to determine which track contains the user's catalog 
(refer to the catalog track definition). 

The lower 3 bits (rightmost octal digit) of the user index are used to group users together into 
subfamilies. Each permanent file family consists of eight subfamilies, subfamily 6 through subfamily 7. 
Any user whose index ends in belongs to subfamily 0, any user whose index ends in 1 belongs to 
subfamily 1, and so forth. The concept of subfamily is important in a Mass Storage Subsystem (MSS) 
environment. Refer to section 3 for more information. 



DEVICE MASKS 

Two types of device masks exist for each device, the device mask (or primary mask) and the secondary 
mask. 



Device Mask 

The device mask is an 8-bit quantity used to identify the group of users who have the particular device as 
their master device; that is, it identifies the device that contains their file catalogs, all their indirect 
access files, and possibly some or all of their direct access files. (The assigning of direct access files to 
a device is described in the section on secondary masks.) 

If bit i is set in the mask of the device, any user whose index ends in i has this device as a master device. 

Example: 

The device identified by the mask 26I3 is the master device for any user whose index ends in 0, 4, 5, or 7, 
because these bits are set in the mask. 



7 




5 


4 











1 





1 


1 











1 



fin this manual, the user validation and accounting files are referred to as VALIDUs, VALINDs, and 
PROFILa. Refer to table 5-1 for a list of file names that correspond to the appropriate operating 
system levels. 
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FILE5 



DUMP A 



DUMPB 



ARCHIVE FILE A 
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+ ARCHIVE FILE B 
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FILE1 



EOR 



FILE2 
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FILE3 



EOR 



EOF 



FILE 4 



EOR 



FILE5 



EOR 



EOF 



EOF 



MULTIFILE 
ARCHIVE 
FILE 



Figure 1-2. Example of Multifile Archive File Structure 

When masks are assigned by an initialization, the following rules must be observed. 

• Within a family the sum of all the device masks must be exactly 37 7g. 

• Each bit position (0 through 7) must be set exactly once for the masks of the devices in one 
family. 

Example: 

For a family of three devices, 221g, 042g, and 114g are valid device masks because their sum is 377g and 
each bit is accounted for only once. 

10 010 001= 221g 

00 100 010= 042g 

01 001 100= 114g 



11 111 111= 377g 

If the sum of the device masks is less than 37 7g, then at least 1 bit is not set in any of the device masks. 
Any user index ending in such a bit-position value does not reference a device. Therefore, if such a user 
tries to write a permanent file, the system issues an error message. 
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Example: 

For a family of four devices, 142s, 020s, 010s, and 204s are not valid device masks because their sum is 

less than 377s. Any user whose index ends in would have no master device and could not write a 
permanent file. 

01 100 010= 142 8 

00 010 000= 0208 

00 001 000= 010 8 

10 000 10 0= 204 8 



11 111 110= 376 8 



If the sum of the device masks is greater than 377s, then at least 1 bit is set for more than one device 
mask. Any user index ending in such a bit-position value references more than one master device. 

Example: 

For a family of four devices, 212s, 106s, 040s, and 021 8 are not valid device masks because their sum is 
greater than 377s- Bit 1 is set twice, which indicates that any user whose index ends in 1 would have two 
master devices, one with mask 2128 and one with mask 1063. 

10 001 010= 212 8 
n 1 n n n 1 1 n = m£< 











1 






1 
















1 


= 040 8 
= 021 8 


1 


1 


1 


1 


1 


1 


1 

1 


1 


401 8 



It is a necessary but not sufficient condition that all masks for one family total 3778- It is possible, but 
illegal, that in one family the device masks sum to 377s but that some bit is set in more than one device 
mask. 

Example: 

For a family of three devices, 261s, 115s, and 001s are not valid device masks because bit is accounted 
for three times and bit 1 is not set at all. Any user whose index ends in would have three master 
devices. Any user whose index ends in 1 would have no master device. 



1 
1 



110 
1 



1 
10 1 
1 


= 261 8 
= 115 8 
= 001 8 


1 1 


111 


10 1 

1 
1 


377 8 



Secondary Mask 

The secondary mask of a device is an 8-bit quantity used to identify groups of users who can place direct 
access files on the particular device. If bit i is set in the secondary mask of the device, any user whose 
index ends in i can place direct access files on this device. 
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Example: 

A device whose secondary mask is 072 8 can contain direct access files of any user whose index ends in 1, 
3, 4, or 5, because these bits are set in the mask. 
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Direct access files may or may not reside on a master device, depending on the user index and secondary 
mask. The appropriate bit must be set in the secondary mask of the device on which the user's direct 
access files are to reside. A direct access file is placed on a valid device with the most space available 
unless the user specifies a particular device. 

Example: 

The following situations occur for a device whose mask is 26 lg and secondary mask is 07 2 8 . 

• This device is the master device for, and can contain direct access files of, any user whose 
index ends in 4 or 5 (bits 4 and 5 are set in both the device mask and the secondary mask). 

• This device is the master device for, but cannot contain direct access files of, any user whose 
index ends in or 7 (bits and 7 are set in the device mask but not in the secondary mask). 

• This device is not the master device for, but can contain direct access files of, any user whose 
index ends in 1 or 3 (bits 1 and 3 are set in the secondary mask but not in the device mask). 

• This device is not the master device for, and cannot contain direct access files of, any user 
whose index ends in 2 or 6 (bits 2 and 6 are not set in either the device mask or the secondary 
mask). 

Existing direct access files belonging to a special user index [user index whose value is greater than 
3777008 (AUIMX)J are exempt from the secondary mask. That is, when such a file is to be defined on or 
loaded to a device, the secondary mask of the device is not checked. The analyst can define such a file 
on any device in the family and PFLOAD loads such a file to the device from which it was dumped. 

There are no restrictions on the number of devices in one family that can have the same bits set in the 
secondary mask or regarding the sum of the secondary masks for devices in the same family. The 
secondary mask must be a number between and 37 7 8 . 

Example: 

For a family of three devices, 000, 131 8 , and 326 8 are possible secondary masks. Any user whose index 
ends in 0, 3, 4, or 6 can place direct access files on the device whose secondary mask is 131 8 . Any user 
whose index ends in 1, 2, 4, 6, or 7 can place direct access files on the device whose secondary mask is 
326 8 . No user can place direct access files on the device whose secondary mask is 000. Any user whose 
index ends in 4 or 6 can place direct access files on two devices, and any user whose index ends in 5 
cannot use direct access files. 



00 000 000= 000 8 

01 011 001= 131 8 
11 10 110= 326 8 



1 1 

1 



1 1 
1 



111 
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MASS STORAGE TABLE 

The configuration of mass storage devices currently available to the system is defined by the CMR mass 
storage table (MST). Each logical device in this configuration has an entry in this table that contains the 
following information. Refer to the NOS Systems Programmer's Instant for the MST format. 

Device status. 

Number of current users. 

Number of catalog tracks. 

Device mask. 

Location of start of permission data. 

Location of start of catalog tracks. 

Location of start of indirect access files. 

Interlock status. 

Family (pack) name. 

Device number. 

User number for private auxiliary device. 

Available space on device. 

Logical description of device. 

CATALOG TRACK 

A user's catalog track is a track on his master device containing the catalog entries (definition follows) 
that define and specify the location of each permanent file created by any user assigned to that catalog 
track. Users are assigned by groups to catalog tracks according to user index and number of catalog 
tracks on the master device. 

The number of catalog tracks on a device is established when the device is initialized or by default. 
Default values are as follows: 

Type of Device Default Number of Catalog Tracks 



ECS (DE) 4 

844 (DI, DJ, DK, DL) 40 8 

885 (DM, DQ) 10 8 

DDP path to ECS (DP) 4 

Private device 1 
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The number of catalog tracks is always a power of 2; the maximum number is 200 8 . Therefore, the 
possible numbers of catalog tracks on a device are: 

1, 2, 4, 10 8 , 20 8 , 40 8 , 100 8 , 200 8 
Reducing these numbers by 1 produces the following numbers, referred to as track masks. 

0, 1, 3, 7, 17 8 , 37 8 , 77 8 , 177 8 
The track masks in binary form are: 




1 

1 1 

111 

1111 

These track masks (except the first one) have all bits set and when bits 3 through 9 of the user index for 
a particular user are ANDed with the track mask for his master device, the user's catalog track number 
on that device is produced. 

Example: 

For a family of two devices, the following device masks, number of catalog tracks, and track masks are 
valid. 



Device 


Device Mask 
221 8 or 10 010 001 


Number of Catalog 
Tracks 


Corresponding 
Track Mask 


Dev 1 


40 8 


40 8 -l=37 8 or 11 111 


Dev 2 


156 8 or 01 101 110 
377q 11 111 111 


20 8 


20 8 -l=17 8 or 1 111 



A user whose index is 14224 is assigned Dev 1 as his master device because bit 4 (last digit in 14224) is 
set in the device mask for Dev 1. Therefore, Dev 1 contains this user's catalog track. 

The binary form of 14224 is 001 100 010 010 100. 

Therefore, the catalog track number for this user is 22 8 (on Dev 1) because the logical AND of bits 3 
through 9 of the user index with the track mask for Dev 1 is as follows: 

100 010 010 
AND 11 111 



10 10 or 22 8 

The end of a catalog track is indicated by an EOI on the device. All catalog tracks are linked in the 
track reservation table (TRT) and appear as one logical chain. When catalog entries exceed the logical 
track, a continuation track is reserved at the end of the catalog track chain in the track reservation 
table. The disk linkage bytes for the overflowed track point to the continuation track. 



l-l 



60455380 E 



PERMANENT FILE CATALOG ENTRY 

Files in the permanent file system are referenced by dynamically updated permanent file catalog (PFC) 
entries on the catalog tracks of master devices. Whenever a user creates a permanent file, a catalog 
entry that specifies the characteristics of the file, access information about the file, and the location of 
the file are entered on a catalog track on the user's master device. As the user modifies the file, the 
PFC entry is updated to reflect the modification. 

The format of the PFC entry is as follows: 



59 



53 



47 44 41 



35 



23 



17 



word 
I 

2 
3 
4 
5 
6 
7 
8 
9 
l( 
II 
12 
13 
14 
15 



filenam 



file length 



random index 



access count 



ct 



mode 



ef 



dn 



pr 



br 



track 



sector 



creation date and time 



data modification date and time 



last access date and time 



control modification date and time 



file oassword 



utility control date and time 

V//////////////A 



V///////////////A 




user control word 



reserved for installation 



FCFN, FCUI 

FCLF, FCBT, FCBS 

FCRI, FCCD 

FCAC, FCMD 

FCCT, FCAM. FCEF, FCEC, 

FCEO, FCAD 
FCKD 

FCRS, FCBR, FCFS, FCUD 

FGPW 

FCAF, FCAT, FCAA 



FCUC 



FCIW 
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filenam 
userin 
file length 



track 
sector 

random index 
creation date and time 

access count 

data modification date and time 



ct 



mode 



Permanent file name. 

User index of file creator. 

Length of the file in PRUs. For direct access files, the 
length is determined by the TRT entries for the file. 
The permanent file manager (PFM) gets the correct 
length from the TRT before returning a catalog entry to 
the caller. (Refer to PFM in the NOS Reference 
Manual, volume 2.) 

Beginning track of the file. 

Beginning sector of the file. 

Random disk address of first permit sector. 

yymmddhhmmss in octal when this file was first entered 
on the permanent file system. The year (yy) is biased by 
70. 

Total number of times this file has been accessed. 

yymmddhhmmss in octal when data in this file was last 
modified. The year (yy) is biased by 70. For direct 
access files this field is updated only when the file is 
attached in a modifiable mode. 

File category: 

Private. 

1 Semiprivate. 

2 Public. 

Mode of access for semiprivate and public files: 

Write, read, execute, append, modify, and/or 
purge. 

1 Read and/or execute. 

2 Append. 

3 Execute. 

4 Negate previous permission. 

5 Modify. 

6 Read and/or execute, allow modify. 

7 Read and/or execute, allow append. 
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ef 



ec 



dn 



last access date and time 

control modification date and time 

pr 



br 



Error flag: 

No error. 

1 EOI changed by recovery. 
Error code: 

No error. 

1 Error in file data. 

2 Error in permit entries for file. 

3 Error in data and permit entries. 

4 Error in file length. 

5 Reserved. 

6 Reserved. 

7 Reserved. 

Device number (1 through 773) of the device on which 
the direct access file resides if other than the user's 
master device. If the file resides on the master device, 
dn is 0. 

yymmddhhmmss in octal when this file was last 
accessed. The year is biased by 70. 

yymmddhhmmss in octal when this file's control 
information (catalog entry and permit record data) was 
last modified. 

Preferred residencet for this file: 

3 Mass Storage Facility (MSF) residence 
preferred (PR=M specified by file owner). 

4 No preferred residence (PR=N specified by file 
owner). 

Backup requirement t for this file: 

1 Backup required on dump tape (BR=Y specified 
by file owner). 

2 Backup required on dump tape only if the 
current version of the file does not have an 
MSF image (BR=MD specified by file owner). 

3 Backup on dump tape is not to be done (BR=N 
specified by the file owner). 



tRefer to Permanent File Control Statements in volume 1 of the NOS Reference Manual for details on 
the PR and BR parameters. 
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ss 



utility control date and time 

file password 
aflags 



Subsystem code for this file: 

Null subsystem. 

1 BASIC subsystem. 

2 FORTRAN subsystem. 

3 FTNTS subsystem. 

4 Execute subsystem. 

5 Batch subsystem. 

yymmddhhmmss in octal set by PFM and PF utilities 
and used by PFDUMP in determining whether to dump 
the file when the OP=M option is specified. 

Optional password. 

Alternate storage flags; refer to section 3, Mass 
Storage Subsystem, for details. 

Flag Bit Description 

AFVER 52 Verification flag: 

If asa#), a successful 
stage/destage operation has 
occurred and system control 
errors should not be 
encountered. 

1 The PFC entry with asa/0 was 
reloaded and a stage attempt 
has not yet been made. If a 
system control error is 
detected, the probable cause is 
that the asa value is obsolete 
and this is probably because an 
obsolete dump tape was used 
during the reload. 

AFPDR 51 Pseudo release flag: 

The file can be attached 
immediately if it has a disk 
image. 

1 The file has a disk image that 
cannot be attached until the 
MSF image of the file is staged 
to disk. After the stage 
attempt (whether or not it is 
successful), this flag is cleared. 
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alt 



asa 



Flag 



AFPDE 



Bit 
50 



AFPSE 



49 



Description 
Data error flag: 

No unrecoverable read errors 
have been detected. 

1 An unrecoverable read error 
prevented the MSF image of the 
file from being staged to disk. 

System control error flag: 



A FOBS 



user control word 



No system error conditions have 
been detected. 

1 A system error condition 
prevented the MSF image of the 
file from being staged to disk. 

48 Obsolete flag; set to 1 whenever the 

file is attached in write mode. 



mor image \it aaatu/ ia 

current version of the file. 



1 Disk image is the current 
version of the file; the MSF 
image (if asa#0) is obsolete. 

Alternate storage type: 

File resides on disk only. 

1 File has an MSF image. 
Alternate storage address: 

An MSF image of the file does not exist. 

Nonzero Specifies the location of the beginning of 
the file on MSF. The A FOBS flag 
indicates whether or not this MSF image 
is current. 

User control information (FET+11). 
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TRACK RESERVATION TABLE 

Every device in a permanent file system has a label track (usually track 0)t which contains a label sector 
describing the device (family name, device mask, secondary mask, location of permit information, 
catalog information, and indirect files) and a number of physical record units (PRUs) containing the 
TRT. The TRT describes the physical layout of data on the device and is the key to allocating 
information on the device. 



The TRT contains single-word entries that define track linkage and bit-setting controls for those tracks 
(figure 1-3). Each word has four 12-bit linkage bytes and three sets of 4-bit control settings that match 
the four bytes (figure 1-4). Linkage format is given in figure 1-5. 

The numbering of the 12-bit linkage bytes or cells corresponds to the numbering of tracks on the device, 
with the first track starting at 4000. The entry in a cell references the next cell and its associated 
track. This next track either continues the information or starts a new sequence depending on the 
first-track bit setting. 

Figures 1-3 and 1-4 show a sequential linkage of tracks (in figure 1-4, from track 4000 to track 4001 to 
4002 to 4003). This numerical sequence is purely illustrative. The linkage could just as well have been: 



4000- 



-4002 



-4015- 



4012 



59 




47 




35 




23 




11 


7 


3 


Track 
Link 


Track 
Link 


Track 
Link 


Track 
Link 


P 


i 


r 




t 


4 


t 



































To next 
TRT word 

Track Link 



Address of the next track that is a logical 

continuation of this file. (The track links are shown 

as sequential within a word, but this is not a 
requirement.) 

Bit settings for identifying the first track of a 
preserved file (permanent file chain or queued file). 

Bit settings for establishing interlock of a track. 

Bit settings for track reservation. 



Figure 1-3. Track Reservation Table Word 



tThe label track is always track for an 844 device. 
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Track 
Reservation Bits 



4000 



4001 



4002 



4003 



4001 


4002 


4003 


4004 









' I 



Matching of four reserve track bit settings with correspond- 
ing tr»ar»Lr link' Sutpc Thp ssmp r»r»r»r*e»sr»nnripnr»p hr>l<i<? fnr thp 

interlock bits (4 through 7) and the first-track bits (8 
through 11). 



Figure 1-4. Bit Settings for Track Link Bytes 



The first group of control settings (bits 8 through 11) is used to identify those tracks which begin a 
sequence of permanent file information. If any one of these bits is set, the associated track is the first 
track of a chain that may extend across a number of tracks. This chain can be a direct access file, an 
indirect access file data chain, a catalog chain, a permit chain, or a queued file. 

The second group of control settings (bits 4 through 7) is used to interlock tracks. If any one of these 
bits is set, the associated track cannot be accessed as long as this bit remains set. Whenever a file is 
accessed, the system automatically interlocks the catalog track containing the file. The interlocking 
capability is necessary because PFM may be processing several requests directed at one file 
simultaneously. Without interlock, these requests could overlap. 

The third group of control settings (bits through 3) is used to identify reserved tracks. A track is 
reserved either because it has data written on it or it is a flawed track. A flawed track is removed 
from availability by reservation at deadstart, by subsequent initialization, or by reformatting with the 
FORMAT utility for 844 devices. 
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LINKAGE 
BYTE 



OCTAL INDICATION 
OF THE NEXT WORD 
IN THE CHAIN 



INDICATES WHICH 
BYTE IN THE WORD 
IS BEING REFERENCED 



JT 



4XXX = I XX XXX TITX )T YY 



L 



c Jr H ! S'JJ S SET » TH,S ,s A Li »* byte; 

m 7JI J£L SET ' TH,S ,S THE LAS T TRACK 
IN THE CHAIN AND THE NUMBER IS THE SECTOR 

Sf^o%S^o S n E ) CT ° R C0NTA,N,NG the E01 (end 



EXAMPLE : THIS ILLUSTRATES THE SEQUENTIAL LINKAGE 



4053 



4075 



•4077 



-0100 



WORD 12 8 



WORD I7 8 



BYTE 
4050 


BYTE 1 
4051 


BYTE 2 
4052 


BYTE 3 
4053 














4075 









100 000 III 101 



BYTE 
• 4074 




BYTE I BYTE 2 

4075 4076 



BYTE 3 
4077 



4077 



0100 



* 



100 000 I II III 



LAST 

SECTOR 

(EOI) 



Figure 1-5. Linkage Format with Example 
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FAMILY 

A family is a collection of 1 to 63 logical devices identified by a one- to seven-character family name. 
Users and their files are grouped together according to the family available to them. Usually, the 
grouping is within the configuration on which these users normally run jobs. However, a family can be 
connected to any configuration and still relate to the same users and files. 

An auxiliary device, identified by a one- to seven-character pack name, is a single device that is not 
included in any family and can be accessed by validated users from any family. An auxiliary device 
provides users with an alternative to the master devices for storing and accessing permanent files. Use 
of auxiliary devices enables an installation to provide special sets of permanent files for selected users 
or for designated periods. For example, an auxiliary device could be made available from 1200 to 1700 
every day for any properly validated user. 

A permanent file device is either a member of a family or an auxiliary device. Permanent files on a 
family device are accessed through user catalogs contained on a master device within the family. The 
user catalogs that reference permanent files on an auxiliary device are contained on that device; that 
is, an auxiliary device is a self-contained entity. 

Families and auxiliary devices are defined at installation time in the PF entry or by the MSI parameters, 
FM and DN.t Normally, a configuration has one family available. Additional families can be defined or 
introduced (on removable devices) in the same configuration. If more than one family is available in a 
configuration, the user supplies the family name at login or on the USER statement in a batch job. The 
default family is used if no family name is supplied. tf 

A system origin job can use the FAMILY control statement to change the family name associated with 
the job. If the FAMILY statement is included in any nonsystem origin job, the job aborts. The format 
of the control statement is: 

FAMILY, family. 

family One- to seven-character name of a family of permanent file devices. If omitted, 

the default family name specified at deadstart is assumed. 

If an alternate family of permanent file devices is introduced into the configuration without a VALIDUs 
file, the job to create VALIDUs could include a FAMILY statement to identify the alternate family. If 
the family parameter is omitted, the default family name is assumed. 

Figure 1-6 is an example of a typical set of configurations. 

Example: 

One configuration with six permanent file devices (EST ordinals 1 through 6) is identified as system A. 
Three of the devices are grouped into a family with the name FAMA. They have device numbers 40, 41, 
and 42. The remaining three ordinals have been defined as removable. This means that the system will 
allow family and auxiliary devices to be introduced on these equipments during system operation. 



f Refer to the DSD command, INITIALIZE, in the NOS Operator's Guide. 
ttThe default family name is specified at deadstart time and cannot be changed dynamically. 
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SYSTEM A 



SYSTEM B 



FAMA 



EQUIPMENT 
DEFINED AS { 
REMOVABLE 



EST 



DEVICE 
NUMBER 



40 



41 



42 



AUXILIARY 
DEVICES 

AUX1 




EST 



DEVICE 
NUMBER 



40 



41 



42 



FAMB 



EQUIPMENT 
} DEFINED AS 
REMOVABLE 



Figure 1-6. Example of Families in Two Configurations 

A second configuration with six permanent file devices is identified as system B. Three of the devices 
have been grouped into a family with the name FAMB. They also have device numbers 40, 41, and 42. 
The remaining three pieces of equipment have been defined as removable. 

Two auxiliary devices are available to both systems. These have the pack names AUX1 and AUX2. 

Users of FAMA would normally run jobs on system A. Users of FAMB would normally run jobs on system 
B. 

The removable equipment on system A (EST 4, 5, and 6) could be used for two purposes: 

• To mount auxiliary devices AUX1 and/or AUX2 as required by users of FAMA. If users of 
FAMB need access to AUX1 and/or AUX2, these auxiliary devices will have to be mounted on 
some combination of EST 4, 5, and 6 on system B. 

• To mount FAMB devices when they are no longer accessible through system B. In this case, 
users of FAMB will have to transfer their access to system A. This transfer could involve a 
physical transportation of disk packs from EST 1, 2, and 3 in system B to EST 4, 5, and 6 in 
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system A, or system A could already have alternate channel connections to EST 0, 1, and 2 in 
system B but would define them as EST 4, 5, and 6 in its own system. If the users of FAMB 
access their files through system A, they submit their jobs to system A or dial into system A 
using a different telephone number. (They would dial the same number if switching of the 
communication gear is done.) 

Assuming that access to all of FAMB is transferred from system B to system A, the new array 
of system A will be as illustrated in figure 1-7. System A now has two families, its original 
default family FAMA and the newly attached FAMB whose devices now have the EST ordinals 4, 
5, and 6. Its device numbers (40, 41, and 42) remain the same. These happen to be the same as 
those used within FAMA but device numbers only provide uniqueness between devices within a 
family. Accordingly, total uniqueness of a device is provided by the combination of family 
name and device number. 

Users of FAMA will still be able to access their file without specifying the family name since 
FAMA is still the default for system' A. However, users of FAMB will have to specify to system 
A that they belong to FAMB either at login or on the USER statement. 

If another equipment (EST 7) were available on system A, either auxiliary pack AUX1 or AUX2 
could be mounted on it and users from either family could access files on this pack. 



SYSTEM A 



SYSTEM B 



NOT IN 
OPERATION 



EST 



FAMA 



FAMB { 




EST 



DEVICE 
NUMBER 



40 



- 3 



41 



42 



> FAMB 



Q 



J 



EQUIPMENT 

} DEFINED AS 

REMOVABLE 



Figure 1-7. Example of Transfer of Family Access 
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CALLING THE UTILITIES 

Permanent file utility operations can be initiated through console input to a K display, card input (batch), 
or terminal entries. However, for batch or terminal input, the user must be validated for system origin 
privileges and DEBUG must be on. 



CONSOLE INPUT 

Input from the console requires the following sequence of entries and responses. 

1. Call PFS by typing: 

X.PFS. 

The B display indicates the console point to which PFS is assigned. To the right of the entry 
appears the following message: 

REQUEST *K* DISPLAY 

2. Activate the K display for that control point by typing: 

K,n. (n is the control point number of PFS specified on the B display) 

The display shown in figure 1-8 appears on the left screen. Instructions at the bottom of the 
display describe how to select the desired utility. 

3. Activate the right K display by typing: 

KK. 

The display shown in figure 1-9 appears on the right screen. A description of the permanent file 
utility options is shown. 

4. Select the desired utility by typing: 

K.uo. 

where uo is one of the following: 
uo Description 

AT Catalog archive file. 

CA Catalog permanent files. 

CP Copy archive file to a control point. 

DU Dump permanent files. 

LD Load permanent files. 
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""- UTILITY OPTIONS *** 

CURRENT 
OPTION VALUE DESCRIPTION 



ENTER K.UO. WHERE -UO- IS 

AT - TAPE CAT CA - DEVICE CAT 

CP - TAPE COPY DU - DUMP LD - LOAD 



Figure 1-8. Initial Permanent File Utilities Left K Display 
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: " PERMANENT FILE UTILITY OPTION DESCRIPTION " : 
OPTION DESCRIPTION 



UT -UTILITY- 



LO -LIST OPTION- 



OP -UTILITY OPTIONS 1 



; LD 
DU 
CA 
AT 
CP 



- PFLOAD 

- PFDUMP 

- PFCAT 

- PFATC 

- PFCOPY 



T - FILES PROCESSED CATALOG 
C - PERMANENT FILE 

DEVICES CATALOG 
E - ERRORS 
S - SUMMARY 

C - CREATION- 

A - LAST ACCESS" 

M - LAST MODIFICATION- 

I - INDIRECT ACCESS-- 

D - DIRECT ACCESS-- 

B - BEFORE 

P - PURGE AFTER DUMP 

R - REPLACE 

N - NONINITIAL LOAD 

Q - ADD CATALOG AND PERMIT RECORDS 

E - EXTRACT CATALOG IMAGE RECORD 

- OMIT CATALOG IMAGE RECORD 

S - SUPPRESS MSS STAGING 

Z - ZERO OUT ASA LINKAGE 



NOTE - OPTIONS ENTERED AS FOLLOWS - 

LO = TCS • OR 
OP = CIBP 

" ONLY ONE TYPE OF DATE MAY BE SPECIFIED 
"" ONLY ONE ACCESS OPTION MAY BE SPECIFIED 



Figure 1-9. Permanent File Utilities Right K Display 
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The parameter options available under the chosen utility appear on the left screen. Figure 1-10 
shows the left screen after the DU utility has been called (T). The TCE appearing after the 
LIST OPTION ©indicates that 

T Files processed 

C Catalog files 

E Errors 

are the listings available for the PFDUMP utility. Different combinations of list options are 
available with the other utilities. 

The CAMIDBPS® appearing after the UTILITY OPTION indicates that 

C Creation 

A Last access 

M Last modification 

I Indirect access files 

D Direct access files 

B Before date and time 

P Purge after dump 

S Suppress MSS staging 

are the options available for the dump utility. Different combinations of utility options are 
available with the other utilities. 

5. Select the desired parameter options by typing: 

K.opt^=val^,opt2=val2,—>opt n =val n . 

where the optj=valj are selected from the parameter option list on the left screen. The selected 
parameters replace the default values listed on the left screen (refer to Description of 
Permanent File Utility Parameters later in this section). 

6. Initiate execution by typing: 

K.GO. 

The lower lines of the left display ©disappear and are replaced by: 

DEVICE MASK 

DATE TIME 

Values appear with these identifiers as processing continues. 
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PFDUMP OPTIONS (T)* *** 



CURRENT 


OPTION VALUE 


FM = 





PN = 





DN = 





TD = 





UN = 





UI = 





PF = 





DD = 


-- N/A -- 


DI = 


-- N/A -- 


LO = 





L = 


OUTPUT 


OP = 





EO 


PROCESS 


SD 


NO SETTING 


UD 


-- N/A -- 


DT = 





TM = 





AD = 


79/09/10 


AT = 


00.00.00 


BD = 





BT = 






1 



DESCRIPTION 

FAMILY NAME 

PACK NAME 

DEVICE NUMBER 

TRUE DEVICE NUMBER 

USER NUMBER 

USER INDEX 

PERMANENT FILE NAME 

DESTINATION DEVICE NUMBER 

DESTINATION USER INDEX 

LIST OPTIONS VALID - 
OUTPUT FILE NAME 

UTILITY OPTIONS VALID - 

ERROR OPTION 

DISK SPACE RELEASE DATE 

UTILITY CONTROL DATE 

DATE YYMMDD 

TIME HHMMSS 

AFTER DATE 

AFTER TIME 

BEFORE DATE 

BEFORE TIME 



TCE (T) 

CAMIDBPS (5) 



YYMMDD 
HHMMSS 
YYMMDD 
HHMMSS 



NOTE - N/A DENOTES INVALID PARAMETER © 



t The circled numbers are identified in the text. 



Figure 1-10. PFDUMP Left K Display (Sheet 1 of 2) 
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PFDUMP OPTIONS **« 



CURRENT 
OPTION VALUE 

T = TAPE 

NT 7-TRACK 

NR REWIND 

NU UNLOAD 

SF = 

N = -- N/A -- 

V NO VERIFY 
VF = PFVER 

MF = -- N/A -- 

RD = 



DESCRIPTION 

ARCHIVE FILE NAME 

NINE TRACK 

NO REWIND 

NO REWIND - UNLOAD 

SKIP FILE 

NUMBER OF FILES TO PROCESS 

VERIFY FILE GENERATION 
VERIFY FILE NAME 

MASTER FILE NAME 

RELEASE DATA FILE NAME 



NOTE - N/A DENOTES INVALID PARAMETER 



Figure 1-10. PFDUMP Left K Display (Sheet 2 of 2) 
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BATCH INPUT 

To call a utility from a batch job, the user must be validated for system origin privileges and DEBUG 
must be on. The following deck structure is used to call a utility. 

Job statement 

USER statement 

CHARGE statement (if necessary) 

PFuo(opt 1 =val 1 ,opt2=val2,...,opt n =val n ) 

where uo is one of the following utility options, and optpvalj is a desired parameter option for the 
selected utility (refer to Parameters for the Permanent File Utility Control Statements). 

uo Description 

ATC Catalog archive file. 

CAT Catalog permanent files. 

COPY Copy archive file to control point. 

DUMP Dump permanent files. 

LOAD Load permanent files. 

When the system reads the PFuo control statement, the K display appears. Parameters were entered on 
the control statement and cannot be entered via the K display. However, if an error in parameters is 
detected at initiation of a utility, control is returned to PFS and parameters can then be entered via the 
K display. 



TERMINAL INPUT 

The format of terminal input for calling the permanent file utilities is substantially the same as that for 
batch input. The user must be validated for system origin privileges and DEBUG must be on. The user 
enters the batch subsystem (or uses the X command), calls the desired utility, and enters the appropriate 
parameters with the command 

PFuo(opt]=vali,opt2=val2,—>optn=val n ) 
where uo and optpvalj are the same as for batch. 



PARAMETERS FOR THE PERMANENT FILE UTILITIES 

Table 1-1 indicates the parameter options accepted by each permanent file utility. An X indicates that 
the parameter option is accepted; a blank indicates that the parameter option is not accepted. Refer to 
the following descriptions of parameters for more information. 
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TABLE 1-1. PERMANENT FILE UTILITY PARAMETER OPTIONS 



Parameter 


Utility 


PFATC 


PFCAT 


PFCOPY 


PFDUMP 


PFLOAD 


AD 


X 


X 


X 


X 


X 


AT 


X 


X 


X 


X 


X 


BD 


X 


X 


X 


X 


X 


BT 


X 


X 


X 


X 


X 


DD 










X 


DI 










X 


DN 




X 




X 


X 


DT 


X 


X 


X 


X 


X 


EO 








X 


X 


FM 




X 




X 


X 


L 


X 


X 


X 


X 


X 


LO 


X 


X 


X 


X 


X 


MF 






X 






N 


X 




X 




X 


NR 


X 




X 


X 


X 


NT 


X 




X 


X 


X 


NU 








X 




OPt 


X 


X 


X 


X 


X 


PF 


X 


X 


X 


X 


X 


PN 




X 




X 


X 


RD 








X 




SD 








X 




SF 


X 




X 


X 


X 


T 


X 




X 


X 


X 


TD 








X 


X 


TM 


X 


X 


X 


X 


X 


UD 










X 


UI 


X 


X 


X 


X 


X 


UN 


X 


X 


X 


X 


X 


V 








X 




VF 








X 




tThe parameters valid with the OP option 
explained in the OP=opt description. 


depend upon tl 


le utility being 


called, as 
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DESCRIPTION OF PERMANENT FILE UTILITY PARAMETERS 

AD=yymmdd After date in the form of year, month, day. Files having a last aeeess date (if 

OP=A), a creation date (if OP=C), or a utility control date (if OP=M) more recent 
than this date are to be processed. AD=yymmdd cannot be used if DT=yymmdd, 
TM=hhmmss, or OP=B has been specified. If AT=hhmmss is specified, the default 
for AD is the current date. If neither AD nor AT are specified, after date and 
time are not used as selection criteria. 

AT=hhmmss After time in the form of hour, minute, second. Files meeting the AD=yymmdd 

criterion and having a last access time (if OP=A), a creation time (if OP=C), or a 
utility control time (if OP=M) more recent than this time are to be processed. 
AT=hhmmss cannot be used if DT=yymmdd, TM=hhmmss, or OP=B has been 
specified. If AD=yymmdd is specified, the default is 000000 (midnight). If neither 
AD nor AT are specified, after date and time are not used as selection criteria. 

BD=yymmdd Before date in the form of year, month, day. Files having a last access date (if 

OP=A), a creation date (if OP=C), or a utility control date (if OP=M) prior to this 
date are to be processed. BD=yymmdd cannot be used if DT=yymmdd, 
TM=hhmmss, or OP=B has been specified. If BT=hhmmss is specified, the default 
is the current date. If neither BD nor BT are specified, before date and time are 
not used as selection criteria. 

BT=hhmmss Before time in the form of hour, minute, second. Files meeting the BD=yymmdd 

criterion and having a last aeeess time (if OP=A), a creation time (if OP=C), or a 
utility control time (if OP=M) prior to this time are to be processed. BT=hhmmss 
cannot be used if DT=yymmdd, TM=hhmmss, or OP=B has been specified. If 
BD=yymmdd is specified, the default is 000000 (midnight). If neither BD nor BT 
are specified, before date and time are not used as selection criteria. 

DI=userin One- to six-digit number which specifies the destination user index under which 

P FLO AD loads all files being processed. Default is (no destination user index). 
This parameter is assumed octal unless the D radix or a nonoctal digit is specified. 

DD=dn One- or two-digit number which specifies the alternate (or default) device to 

which PFLOAD loads files when the device on which a file is to be loaded cannot 
be found, is not defined in the system, or cannot accept the file because of 
secondary mask restrictions. Default is (no device is the alternate). This 
parameter is assumed octal unless the D radix or a nonoctal digit is specified. 

DN=dn One or two-digit octal number which specifies the device within the family to be 

cataloged, dumped, or loaded. For PFLOAD, refer to Specified Option Check in 
the description of PFLOAD for more information. For PFCAT or PFDUMP, the 
following distinctions are made. If the specified device is a master device, all 
files cataloged on it (whether or not they reside on the device) are processed if 
they also meet all other specified selection criteria. However, files that reside on 
the device that are cataloged elsewhere are not processed. If the specified device 
is not a master device, all files residing on it are processed if they also meet all 
other specified selection criteria. (For nonmaster devices the DN and TD 
parameters have the same effect.) Default is (all devices are to be cataloged, 
dumped, or loaded). 

DT=yymmdd Date in the form of year, month, day to be used with OP=C, A, M, or B option. 

Default is current date if OP=A, C, or M is specified; otherwise, it is (no date). 
DT=yymmdd cannot be used if AD=yymmdd, AT=hhmmss, BD=yymmdd, or 
BT=hhmmss has been specified. 

EO Specifies that PFDUMP or PFLOAD does not process files with mass storage 

errors. If EO is not specified, PFDUMP dumps files, and PFLOAD loads files, 
regardless of mass storage errors. 
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FM-family One- to seven-character name of the family of permanent file devices to be 

cataloged, dumped, op loaded. This parameter option is not required if only one 
family of devices is active in the system. Default is the default system family 
name. 

L=filenam One- to seven-character name of the file on which reports are to be written. 

Default is OUTPUT. 

LO=opt Characters) specifying the type of information which the permanent file utility 

should include in its output report. Default is (no options selected). 

opt Significance 

C List all files in the Catalog Image Record (CIR). 

E List errors. 

S List cumulative statistics for catalog. 

T List all permanent file catalog (PFC) data for all files. 



MF-filenam One- to seven-character name of the master file at a control point on which 

PFCOPY copies all the files extracted from a designated archive file. Default is 
no name; that is, the archived files are copied as individual files retaining their 
permanent file names. 

This option allows the user to extract a file from an archive file and change its 
name as a local file. 

N=n 0ne " or two-digit number which specifies the number of archived files on an 

archive file to be processed. If n=0, one file is processed. Default is 1. This 
parameter is assumed decimal unless the B radix is specified. (Refer to the 
example under the SF option.) 



NR 



Specifies that no files are to be rewound before or after they are processed. If 
NR is not specified, the following are defaults. 

Rewind before Rewind after 

Processing Processing 

PFATC X x 

PFCOPY X x 

PFDUMP X 

PFLOAD X X 



NOTE 



When positioning a file, the analyst should take 
into account that the first step in processing the 
file is to read or write the file label. 



1-28 



60455380 G 



NT Specifies a nine-track archive tape. Default is seven-track (MT). The utility sets 

the recording density to the installation default for the specified track type if the 
archive tape is not preassigned. 

NU Specifies that the archive, verify, and release data files created by PFDUMP are 

not to be unloaded. If NU is not specified, PFDUMP automatically unloads these 
files after creating them; if these files are on tape, the tape is returned to the 
takeup reel and vacuum released. At this point, the reel is either removed or 
physically reloaded for further use. 

The NR and NU parameters can be used together to generate several dumps on an 
archive file. For example, the following series of PFDUMPs can be used to 
generate three dumps on one archive file. 

PFDUMP(...NU) PFDUMP automatically rewinds before but not after 

processing. PFDUMP normally unloads after 
processing, but NU cancels the unload and leaves the 
file positioned at the end of this dump. 

PFDUMP(...,NR,NU) NR cancels the rewinding before the dump, and the 

second dump is written after the first. NU cancels 
the unload and leaves the file positioned at the end 
of the second dump. 

PFDUMP(...NR) NR cancels the rewinding before the dump, and the 

third dump is written after the second. The file is 
then automatically unloaded. 

OP=opt One- to seven-character string specifying the utility options which control the 

processing of files. Many of the options require additional parameters to 
complete the definition of the OP selection. Default is (no options selected). 

Only one of the following three options can be used at a time. Each requires TM 
and DT parameters to establish a dividing time after which all files that meet the 
criteria of the option are singled out for processing. 

A Make selection according to time of last access. 

C Make selection according to time of creation. 

M Make selection according to time of last modification. 

The B option can be used only with A, C, or M. (For example, OP=CB). It cannot 
be used if the AD, AT, BD, or BT option has been specified. 

B Denotes that the time and date specified by the TM and DT parameters 
is a dividing time before, rather than after, which all files that meet the 
criteria of the option are singled out for processing. 

Only one of the following two options can be used at a time. They can be used in 
conjunction with the previous temporal options. 

D Select direct access files only. 

I Select indirect access files only. 
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The following options are used only with PFDUMP. Only one of them can be used 
at a time. 

P Purge after dump. All files included in the dump are purged after the 
dump is completed. This option can be used only when the dump is 
initiated from the console. 

St Suppress staging of files. If a file to be dumped resides on the Mass 
Storage Facility (MSF) and not on disk, it is not staged to disk and only 
its PFC and permit entries are copied to the archive file. If OP=S is 
omitted, the MSF file is copied to disk and included in the dump. This 
option should normally be specified for full dumps. 

The following five options are used only with PFLOAD. 

N Noninitial load. This option may still be specified (for compatibility with 
earlier versions of PFLOAD, but is ignored. PFLOAD now considers all 
loads to be noninitial (that is, PFLOAD never assumes that a device has 
just been initialized and contains no permanent files). 

R Load with the replace option. If R is specified, PFLOAD loads all 
selected files from the archive file. If R is not specified, PFLOAD loads 
only those files selected from the archive file for which no corresponding 
files (files with identical file names and user indexes) already exist in the 
permanent file system. 

E Extract only the catalog image record (CIR). Refer to the PFLOAD 
description for information about the CIR. PFLOAD reads the CIR from 
the designated tape, generates a random file and directory, and requests 
the next archive file without processing any of the files after the CIR on 
the first archive file. 

O Do not read the CIR. PFLOAD does not read the CIR for the specified 
archive file but processes the records in this archive file. PFLOAD then 
terminates normally without requesting another archive file. 

Zt Zero the asa field in the PFC entry when the PFC entry is loaded, if the 
asa field points to an MSF image. Also suppresses the loading of PFC 
only files. Default is to leave the asa field intact and to load PFC only 
files. OP=Z should normally be omitted if the device has to be recovered 
and should be specified if data for the file is being reloaded. 

The following option is used only with PFCOPY. 

Q Select leading records. The archived file that is copied to a control point 
includes two header records, one with the catalog entry for the file and 
the second with the permit information for the file. 

PF=filenam One- to seven-character name of the permanent file to be processed. PF is 

associated with UI. Default is that permanent file name is not a selection 
criterion. 



t Refer to section 3, Mass Storage Subsystem, for more information. 
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PN=paeknam One- to seven-character name of the auxiliary device to be cataloged, dumped, or 

loaded. The device must be mounted and available. Default is that pack name is 
not a selection criterion. 

RD=filenamt One- to seven-character name of the release data file (RDF) to be created by 

PFDUMP, which identifies those MSF-resident files that are pointed to by PFC 
entries at the time of the dump. The MSS utility ASVAL uses this file to identify 
unneeded MSF-resident files whose space can be released. If RD alone is 
specified, the release data file created is named RDF. This file observes the 
NU/NR parameter rules. Default is that PFDUMP does not create an RDF. 

SDt Specifies that PFDUMP is to enter the date and time when the dump was initiated 

into the inhibit date/time field of the master device. This date/time entry is used 
by the MSS utility ASMOVE to inhibit the releasing of the disk image of any file 
with a BR=Y attribute which was last modified after this date/time. The disk 
space can be released after the next incremental or full dump is taken. 

SF=n One- or two-digit number which specifies the number of archived files to be 

skipped before processing begins. Default is 0. This parameter is assumed 
decimal unless the B radix is specified. 

Example: 

To load the fourth and fifth files on archive tape AT containing six archived files 
(Fl, F2, F3, F4, F5, and F6), the following PFLOAD statement can be used. 

PFLOAD(T=AT, SF=3, N=2) 

SF causes PFLOAD to skip Fl, F2, and F3, and to begin processing with F4. N=2 
causes PFLOAD to process F4 and F5. 

T=filenam One- to seven-character name of the file on which to store or read archive files. 

Usually, filenam is a tape, but it can be a mass storage device. Default is TAPE. 

TD=dn One- or two-digit octal number which specifies the device within the family to be 

dumped or loaded. For PFLOAD refer to Specified Option Check in the 
description of PFLOAD for more information. For PFDUMP, the following 
distinctions are made. If the specified device is a master device, all files 
cataloged and/ or residing on it are processed if they meet all other specified 
selection criteria. If the specified device is not a master device, all files residing 
on it are processed if they also meet all other specified selection criteria. (For 
nonmaster devices the DN and TD parameters have the same effect.) Default is 
(all devices are to be dumped or loaded). 

TM=hhmmss Time in the form of hour, minute, second to be used with OP=C, A, M, or B 

option. Default is 0. TM=hhmmss cannot be used if the AD, AT, BD, or BT 
parameter has been specified. 

UDt Specifies that PFLOAD is to update the utility control date and time field in the 

PFC entry for the file being loaded. This ensures that the file will be considered 
for inclusion in the next incremental dump. UD should normally be specified when 
a particular user's files are being reloaded, but should normally be omitted when a 
full device is being reloaded. 



f Refer to section 3, Mass Storage Subsystem, for more information. 
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UI=userin One- to six-digit number which specifies the user index under which files to be 

processed are located. If UI is specified, DN need not be specified because the 
utility will locate the proper device. Default is that user index is not a selection 
criterion. This parameter is assumed octal unless the D radix or a nonoctal digit 
is specified. 

UN=usernum One- to seven-character user number associated with the PN parameter. The user 

number must match information in the mass storage table (MST) for the specified 
pack name. If UN is specified and PN is not, the utility will convert usernum to a 
user index. If, in addition, DN is not specified, the utility will locate the proper 
device in the family. Default is that user number is not a selection criterion. 

V Specifies that PFDUMP is to produce a verify file which is a duplicate of the 

archive file it creates. After PFDUMP has completed processing, this file is 
verified with the primary archive file. Default is no verify file written. 

If NU is specified, neither the archive file nor the verify file is unloaded. Thus, 
multifile verify files can be generated along with multifile archive files. 

Example: 

The following series of commands creates a two- file archive file (AA) and a 
matching verify file (BB). The VERIFY command compares the accuracy of the 
duplication. (Refer to volume 1 of the NOS Reference Manual for a complete 
description of VERIFY.) 



PFDUMP(T=AA,VF=BB,V,NU) 



PFDUMP(T=AA,VF=BB,V,NU,NR) 



VERIFY(AA,BB,N=0,A,R) 



The dump is written on archive file AA. 
A duplicate is written on the verify file 
BB. PFDUMP does not rewind after 
processing. 

A second dump is written after the first 
on both the archive (AA) and the verify 
(BB) files. Each dump produces a separate 
file on the archive and verify files. The 
NR is necessary to inhibit the rewind 
before the dump. 

A binary comparison of AA and BB is 
performed. If words do not match, this 
command lists: 



Record number 

Word number within the record 

Words from both files that do not 
match 

N=0 specifies that the verify terminates 
when the first empty file is encountered. 
The A parameter specifies an abort if a 
mismatch is found. R rewinds both files 
before and after the verify. 
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VF=filenam One- to seven-character name of the verify file on which PFDUMP stores a 

duplicate copy of the archive file it creates. The verify file can reside on mass 
storage or on tape. Default is PFVER. 



PREASSIGNING THE ARCHIVE FILE 

In all permanent file utilities except PFCAT, consideration should be given to the assignment of the 
archive file. A nine-track archive tape can be specified with the utility parameter NT. This can also be 
specified when the file is assigned to a control point. The relation between file preassignment and NT is 
shown in the following cases. 

• If the file specified by the T option (or the default file TAPE) has been assigned to a control 
point prior to the utility call, that file is used as the archive file. In this case, NT is ignored if 
specified. 

Example: 

Archive file assignment and the utility call are made with the following statements. 

LABEL(TAPE,VSN=A) OF ASSIGN(MS,TAPE) 

PFDUMP(NT) PFDUMP(NT) 

In this example, the file TAPE is already at a control point when the utility is called. The 
utility does not make a tape request, and NT is ignored. 

• If a vsn for the archive file has been specified prior to the utility call, the assignment of the 
archive file is made to a tape having the specified vsn and the installation default density for 
the specified track type (nine-track if NT is specified, seven-track otherwise). 

Example: 

Tape assignment and the utility call are made with the following statements. 

VSN(TAPE=A) 
PFDUMP(NT) 

In this example, the vsn has been specified prior to the utility call. The system attempts to 
assign a nine-track tape with vsn A at the installation default density for nine-track tape. 

• If no archive file preassignment was done, the operator is requested to assign the unit to be used 
with the attribute specified by the NT parameter. 

Example: 

The following statement is issued. 

PFDUMP(NT) 

The operator is requested to assign a nine-track unit. He can assign a nine-track unit, null 
equipment (77g), or any mass storage device defined as temporary. If a nine-track unit is 
assigned, recording density is the installation default for nine-track tape. 
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PERMANENT FILE UTILITY ROUTINES 



This section and its subsections describe the permanent file utility routines. The parameter options 
available for each of the routines are listed in table 1-1. 

The LO option allows each permanent file utility to produce a cataloged directory of file information. 
This catalog information is either derived from the catalog tracks on the permanent file device or from 
the archive tape. Although the header information may differ from utility to utility, the format of the 
catalog information remains the same. The foUowing is the general format of the information listed for 
each file on the directory. 



filenam access 
passwrd mc 

pr br rs 

© filenam 

© access 



© 



ct 



© length 

© dn 

© passwrd 

© mc 

© user in 

© mode 

(f(5) subsystem 



@ cdate 
time 



(f^) ladate 
time 

@ dmdate 
time 



ct 



userin 



length dn 
mode subsystem 



cdate ladate dmdate cmdate ucdate 
time time time time time 

flags at asa amsg 



Permanent file name. 



Type of permanent file. This field can be either DIR (direct access) or IND 
(indirect access). 

File category. This field can be either PRIVATE, SEMI-PR, or PUBLIC. 
These categories are described in volume 1 of the NOS Reference Manual. 

Length of the file in PRUs. 

Device number of the mass storage device on which the file resides if other 
than the master device. If the file resides on the master device, this field is 
replaced by an *. 

Password associated with the file. 

Modification count which specifies the number of times the file has been 
accessed. 

User index of the user on whose catalog this file resides. 

Permission mode. This field can be WRITE, MODIFY, APPEND, READ, 
READMD, READAP, or EXECUTE. These modes are explained in detail in 
volume 1 of the NOS Reference Manual. 

Subsystem under which the file was saved. Possible entries include FOR, 
FTNTS, BASIC, EXEC, or BATCH. If this field contains no entry, a 
subsystem is not associated with the file. 

Date and time of file creation. The format is: 

yy/mm/dd. 
hh.mm.ss. 

Date and time of the last access to the file. 

Date and time of the last data modification to the file. 
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(14) cm date 

time 

(15) ucdate 

time 

(16) pr 



17) br 



18) rs 



(19) flags 



0) at 

£l) asa 
22) amsg 



Date and time of the last control information modification made in 
the file's PFC entry or permit entries. 

Utility control date and time set by PFM or a PF utility to ensure 
that the file will be included in the next incremental (OP=M) dump. 

Preferred residence for the file specified by the file owner. This field can 
be either M (MSF residence preferred) or N (no preferred residence). 

Backup requirement for the file specified by the file owner. This field can 
be either Y (backup required on dump tape), MD (backup required only if 
current version of file does not reside on MSF), or N (no backup is to be 
performed). 

Current residence of the file. This field can be D (disk only), A (MSF only), 
or B (both). 

Alternate storage flags set for the file (refer to the description of PFC 
entry earlier in this section for details). If a flag is not set, a dash is listed. 
If an undefined flag is set, an asterisk is displayed. This field can be: 

D Data error flag. 

O Obsolete flag. 

R Pseudo release flag. 

S System control error flag. 

V Verification flag. 

Alternate storage type. This field can be NONE (no MSF image) or MSF (file 
resides on MSF). 

Alternate storage address of the file. 

Appended message, *PFC ONLY, indicating when a PFC ONLY file (that is, 
an entry with PFC and permit entries, but no data) has been processed on 
the archive file. 



Figure 1-11 illustrates a typical page from a cataloged directory. Although this directory was produced 
using the command PFATC(LO=T), directories in similar format could be produced using the other 
utilities. Each of the fields previously described is shown on the figure. 
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P. F. ARCHIVE CATALOG 



PFDUMP 

EQ. MASK 377 



FILE NAME ACCESS FILE-TYPE LENGTH ON CREATION 
PASSWORD MD/CNT INDEX PERM. SUBSYS DATE/TIME 
PR BR R S 
157 |PATA5[ IND. PRIVATE 1 77/11/26. 

1014 WRITE 16.06.29.' 

N Y D 



58 DIRF1 ^ [dIrT] [PRIVATE! © 



N Y D 



15 * 77/11/26. 

1 214 WRITE 16.02.06. 



©, 



159 DIRF2 DIR. PRIVATE ^QI] * 77/11/26. 

1 214 WRITE 16.02.06. 
N Y D 

© 

160 DIRF1 DIR. PRIVATE 15 PH77/1 1/26. 

614 WRITE 16.05.1 l! 
N Y D 

161 DIRF2 DIR. PRIVATE 15 * 77/11/26 
©[PASSW] ["OK?) 614 WRITE 16.05.12. 

N Y D 

162 LIST IND. PR IVATE 2 77/11/26 

N YD ©HI] H1I10 16.06.29. 

163 INED1 IND. PRIVATE 1 77/11/26. 

1014 WRITE I BASIC I 16.06.30.' 

N Y D (^ ' 



164 PR0G1 IND. PRIVATE 2 

1014 WRITE 



16 



N| Y D 



77/11/26. 
16.06.30. 



PAGE 13 
79/04/05. 09.30.15. 

ACCESS DATA MOD CONTROL UTILITY 
DATE/TIME DATE/TIME DATE/TIME DATE/TIME 
ASA FLAG CODES TYPE ASA VALUE 
77/11/26. 77/11/26. 77/11/26. 77/11/26. 
16.06.29. 16.06.29. 16.06.29. 16. 06. 29. 
NONE 

77/11/26. 77/11/26. 77/11/26. 77/11/26. 
16.27.38. 16.02.06. 16.02.06. 16.02.06. 
NONE 

77/11/26. 77/11/26. 77/11/26. 77/11/26. 
16.27.38. 16.02.06. 16.02.06. 16.02.06. 
NONE 

77/11/26. 77/11/26. 77/11/26. 77/11/26. 

16.05.11. 16.05.11. 16.05.11. 16.05.11. 
NONE 

77/11/26. 77/11/26. 77/11/26. 77/11/26. 

16.05.12. 16.05.12. 16.05.12. 16.05.12. 
NONE 

77/11/26. 77/11/26. 77/11/26. 77/11/26. 

16.06.29. 16.06.29. 16. 06. 29. 16.06.29. 
NONE 

77/11/26. 77/11/26. 77/11/26. 77/11/26. 

16.06.30. 16.06.30. 16.06.30. 16. 06. 30. 

NONE _^ ^ 

12) C13) ©_ @ 



®Z—@ 



77/11/26. 
16.06.30 



77/11/26. 
16.06.30. 



77/11/26. 
16.06.30 



NONE 



77/11/26. 
16.06.30. 



165 BPR01 IND. PRIVATE 2 
@ 1014 WRITE 
N [T]D 



77/11/26. 
16.06.30. 



166 BPR02 IND. PRIVATE 1 77/11/26. 
1014 WRITE 16.06.31. 



N Y [F] 



18 



77/11/26. 77/11/26. 77/11/26. 77/11/26. 

16.06.30. 16.06.30. 16.06.30. 16.06.30. 
NONE 

77/11/26. 77/11/26. 77/11/26. 77/11/26. 

16.06.31. 16.06. 31. 16.06.31. 16. 06. 31. 
| NONE 



167 BPR03 IND. PRIVATE 1 77/11/26. 

1014 WRITE 16.06.31.* 
N Y D 

168 BPR04 IND. PRIVATE 1 77/11/26. 

1014 WRITE 16.06.31. 
N Y D 

169 EDP11 IND. PRIVATE 1 77/11/26. 

2 14 WRITE 16.09.07.' 
N Y D 



77/11/26. 77/11/26. 77/11/26. 77/11/26. 
16.06.31. 16.06.31. 1 6.06.3 1. 16. 06. 31. 
(gj) |NONE| 

77/11/26. 77/11/26. 77/11/26. 77/11/26. 
16.06.31. 16.06.31. 16.06.31. 16.06 .31. 
NONE @[ZZ2 



] | I 



77/11/26. 77/11/26. 77/11/26. 77/11/26. 
16.25.51. 16.09.07. 16.09.07. 16.09.07. 
NONE 



Figure 1-11. Sample Directory Produced by PFATC (LOT) 
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CATALOG ARCHIVE FILE (PFATC) 

PFATC produces a cataloged directory of file information derived from an archive file previously 
created by the PFDUMP utility. The format of the directory depends upon the parameter options 
selected. 

If LO=T (list all files processed) is specified, the directory produced is similar to that shown in figure 
1-11. If LO=C (list all files in catalog for system) is specified and the archive file to be cataloged was 
produced by an incremental dump (refer to the PFDUMP utility), the directory produced is similar to that 
shown in figure 1-16. 



CATALOG PERMANENT FILE DEVICE (PFCAT) 

PFCAT produces a cataloged directory of file information derived from catalog tracks on a master 
device. The format of the directory depends upon the parameter options selected. 

If LO=T (list all files processed) is specified, a directory of file information and a mass storage table 
report are produced. The directory is similar to that shown in figure 1-12, However, the files are listed 
according to user index, and totals are given after the files for each user index. The mass storage table 
report gives information about each mass storage device in the system. Figure 1-13 is an example of a 
mass storage table report. Messages issued with this report give information concerning the type and 
status of the device cataloged. The following status messages can be issued, 

ACCOUNT INITIALIZE PENDING. 
CATALOG TRACK OVERFLOW. 
DAY FILE INITIALIZE PENDING. 
ERRLOG INITIALIZE PENDING. 
FORMAT PENDING. 
I/O QUEUE INITIALIZE PENDING. 
PF INITIALIZE PENDING. 
TOTAL INITIALIZE PENDING. 
UNAVAILABLE FOR PF ACCESS. 
8 WORD CATALOG ENTRIES. 

The following types of devices can be listed. 

ALTERNATE SYSTEM 
REMOVABLE DEVICE 
SYSTEM 
TEMPORARY 

If LO=S (list cumulative statistics for catalog) is specified, summary reports of file information for each 
user index and for the entire device are produced. Figure 1-14 lists a page of the information given for 
each user index. Figure 1-15 lists the general device information. 
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CATALOG FILE 79/07/16. 15.03.11. 

DIRECTORY OF PERMANENT FILE DEVICE THETA PAGE 1 
CATALOG OF USER INDEX 3442 

FILE NAME ACCESS FILE- TYPE LENGTH ON CREATION ACCESS DATA MOD 
PASSWORD MD/CNT INDEX PERM. SUBSYS DATE/TIME DATE/TIME DATE/TIME 

PR BR RS ASA FLAG CODES 

1 TBLLNKM DIR. PRIVATE 237 * 79/07/09. 79/07/12. 79/07/10. 

20 WRITE 16.02.37. 18. 16.51. 16.36.47. 

N Y D 

2 DUMP DIR. SEMI-PR 2 * 79/07/09. 79/07/11. 79/07/11. 

4 WRITE 17.54.15. 17.31.31. 17.31.31. 
N Y D 

3 BIG1LPI DIR. PRIVATE 29 * 79/07/10. 79/07/12. 79/07/11. 

5 WRITE 18.16.50. 16.00.40. 09.10.33. 
N Y D 

4 BIG1LP DIR. PRIVATE 10256 * 79/07/10. 79/07/12. 79/07/11. 

5 WRITE 18.18.21. 16.00.48. 09.16.53. 
N Y D 

5 GIBSON DIR. PRIVATE 90 * 79/07/10. 79/07/12. 79/07/11. 

3 WRITE 18.20.00. 18. 16.20. 09.21.36. 

N Y D 

6 LINKM DIR. PRIVATE 1035 * 79/07/11. 79/07/12. 79/07/11. 

6 WRITE 12.25.58. 18. 16.34. 17.15.30. 
N Y D 

7 SCUM DIR. PRIVATE 1584 * 79/07/11. 79/07/12. 79/07/12. 

8 WRITE 12.29.37. 18. 16.42. 08.56.08. 

N Y D 

8 TFK80PL DIR. PRIVATE 286 * 79/07/12. 79/07/13. 79/07/12. 

3 WRITE 13.10.21. 09.37.54. 13.10.21. 

N Y D 



CONTROL UTILITY 
DATE/TIME DATE/TIME 
TYPE ASA VALUE 

79/07/09. 79/07/10. 
16.02.37. 16.36.47. 
NONE 

79/07/10. 79/07/11. 
11.16.03. 17.31.31. 
NONE 

79/07/10. 79/07/11. 
18.16.50. 09.10.33. 
NONE 

79/07/10. 79/07/11. 
18.18.21. 09.16.53. 
NONE 

79/07/10. 79/07/11. 
18.20.00. 09.21.36. 
NONE 

79/07/11. 79/07/11. 
12.25.58. 17.15.30. 
NONE 

79/07/11. 79/07/12. 
12.29.37. 08.56.08. 
NONE 

79/07/12. 79/07/12. 
13.13.53. 13.10.21. 
NONE 



TOTALS 



8 FILE(S) 14219 SECTORS 



Figure 1-12. Directory Produced by PFCAT(LO=T) 



MASS STORAGE TABLE REPORT 
FAMILY /PACK NAME SYSTAA 



76/01/14. 21.51.01. 



DEVICE NUMBER 
DEVICE MASK 
SECONDARY MASK 
D/A USER COUNT 



1 
377 
377 





DEVICE TYPE 
NUMBER UNITS 
USER NUMBER 
EQUIPMENT STATUS 



DI 



ACTIVE 



SYSTEM 
TEMPORARY. 



Figure 1-13. Mass Storage Table Report 
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SUMMARY REPORT 
DIRECTORY OF PERMANENT FILE DEVICE 



40 SYS172 



76/01/14. 21.51.01. 
PAGE 204 



(* = 



USER 



DAF RESIDENT ON OTHER THAN MASTER DEVICE. ) 
INDEX FILES SECTORS AVE. SEC. 



3000 


1 


315 


315 


10 


26 


57 


2 


210 


3 


665 


221 


20 


18 


33 


, 1 


30 


12 


117 


9 


230 


4 


394 


98 


2230 


42 


1543 


36 


40 


18 


58 


3 


60 


4 


15 


3 


100 


23 


552 


24 


150 


3 


50 


16 


160 


6 


247 


41 




160 


4046 


(GROUP T 


1 


29 


202 


6 


201 


5 


21 


4 


1 1 

X J. 




c a n 


O A 



Figure 1-14. Cumulative Statistics by User Index PFCAT (LO=S,DN=40) 
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SUMMARY REPORT 
DIRECTORY OF PERMANENT FILE DEVICE 



76/01/14. 21.51.01. 
40 SYS172 PAGE 207 



INDIRECT ACCESS FILE HOLES 



CATALOG 


NUMBER 


TRACK 


HOLES 





114 


1 


12 


2 


177 


3 


27 


4 


46 


5 


86 


6 


52 


7 


13 


10 


7 


11 


83 


12 


50 


13 


48 


14 


2 


17 


20 


TOTAL 


737 



NUMBER 
SECTORS 

631 
66 

1520 
154 

1368 
891 
238 
277 
120 

1107 

229 

324 

13 

139 



7077 



SUMMARY REPORT 
DIRECTORY OF PERMANENT FILE DEVICE 40 SYS 172 

PERMANENT FILE STATISTICS SUMMARY 

MASTER DEVICE USAGE 

GROUP TOTALS 



76/01/14. 21.51.01. 
PAGE 208 



Ol 


JP TOTAL 


TOTAL 


PERCENT OF 








FILES 


SECTORS 


TOTAL USAGE 









160 


4046 


6 






1 


497 


6193 


10 






2 


475 


7658 


12 






3 


149 


3554 


5 






4 


412 


6320 


10 






5 


213 


5427 


8 






6 


376 


21514 


35 






7 


216 


5693 


9 












TOTAL 


IAF 


DAF 




TOTAL SECTORS 




60405 


24618 


35787 




TOTAL FILES 




2498 


2174 


324 




TOTAL USERS 




94 








AVE. FILES/USER 




26 


23 


3 




AVE. SEC/FILE 




24 


11 


110 



DEVICE TYPE - DI-2 
PERCENT DEVICE USAGE 

DIRECT ACCESS DEVICE USAGE 



DEVICE 

NUMBER 



DEVICE 
TYPE 



TOTAL 
FILES 



59 



TOTAL 
SECTORS 



24 



PERCENT 
USAGE 



35 



40 DI-2 324 35787 35 

Figure 1-15. Cumulative Statistics for Entire Device PFCAT(LO=S,DN=40) 
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COPY ARCHIVE FILE (PFCOPY) 

PFCOPY extracts files from an archive file and copies them to one or more files at a control point. The 
way the files are copied depends upon the parameter options selected. 

If MF=filenam is specified, all the files extracted from the archive file are copied to a control point 
under one master file name (filenam) and they do not retain their permanent file names. 



DUMP PERMANENT FILE (PFDUMP) 

PFDUMP copies (dumps) permanent files to backup storage (an archive file). Dumps can be reloaded by 
the PFLOAD utility and can be accessed by the PFATC and PFCOPY utilities for cataloging and 
copying. The type of dump taken depends upon the purpose of the dump and is determined by the 
parameters selected. Table 1-2 shows the defining characteristics of the three types of dumps. 



TABLE 1-2. PFDUMP TYPES 



Incremental Dump 


Partial Dump 


Full Dump 


OP=M is specified and 
OP=B, BD=yymmdd, and 
BT=hhmmss are not 
specified. 


Any dump that is not in- 
cremental and not full. 

* 


OP=0 is specified or 
OP is not specified. 



Incremental (Selective) Permanent File System Dump 

An incremental dump copies those permanent files modified after a specified date; that is, the OP=M 
option is specified together with the date (AD or DT) and time (AT or TM) options but OP=B, 
BD=yymmdd, and BT=hhmmss are not specified. Other options specified on the PFDUMP call can 
restrict the dump even further. 

For example, the statement 

PFDUMP(OP=MI,AD=790101,AT=100000) 

causes only indirect access files (I parameter) modified after the specified date and time to be dumped. 
Normal procedure at a site is to follow up this dump with successive incremental dumps (usually with a 
periodic advancement of date and/or time). This produces a series of archive files containing successive 
updating of all files in the defined category. (These files can reside on one file - a multifile archive file. 
Refer to the description of the NU option for an example of such a file.) The archive files can then be 
incrementally loaded (refer to the PFLOAD utility) to return the most recently modified versions of the 
archived files to the permanent file system. 

Each incremental dump writes a record (or records) at the beginning of the archive file it creates. The 
record contains catalog images (refer to Catalog Image Record in the PFLOAD section) of all files active 
in the permanent file system when the dump took place. This enables a future incremental load of these 
files on a system or a device basis. 

An example of incremental dumping is given in the PFLOAD section. 
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Partial Permanent File System Dump 

A partial dump copies permanent files according to any specified option(s), except those defining a full or 
incremental dump (refer to table 1-2). For example, the statement 

PFDUMP(OP=D) 

is a partial dump of all direct access permanent files. Similarly, a dump of all files created (OP=C) or 
accessed (OP=A) after a certain date is a partial dump. 

A partial dump can dump files from a certain device (DN or TD option) or can dump all files in the 
system (DN and TD not specified) that meet the criteria of the specified options. 



Full Permanent File Dump 

A full dump copies all files in the system or those cataloged on a specified device. That is, the OP option 
is not specified (or OP=0), and either a particular device is specified (device dump) or no device (DN=0 or 
TD=0) is specified (system dump). 



PFDUMP in a Mass Storage Subsystem Environment 

In an MSS environment, the data for a permanent file to be dumped may reside on MSF and not on disk. 
However, if the file is to be copied to a dump file, it must have a disk image. The analyst can either 
stage the file to disk from MSF in order to include its data on the dump file (OP=S omitted), or copy to 
the dump file only the PFC and permit entries for the file and not the file data (OP=S specified). 
Typically, OP=S is specified for full dumps; otherwise, all MSF files would be included in the dump, which 
is not feasible because of the time involved to dump such a large permanent file base. 

As described in volume 1 of the NOS Reference Manual, the file owner can supply a backup requirement 
for a file via the BR parameter on the DEFINE, CHANGE, or SAVE statement. Options include backup 
on a dump file, backup only if the current version of the file is not on MSF, or no backup on a dump file. 
This partially determines whether or not a file is included in a particular PFDUMP run. Refer to section 
3, Mass Storage Subsystem, for further information on how the PFDUMP utility is used in an MSS 
environment. 



LOAD PERMANENT FILE (PFLOAD) 

PFLOAD loads archived files produced by the PFDUMP utility back into the permanent file system. The 
load can reestablish the permanent file system exactly as it was at the time of the dump, or can load 
only a desired subset of files on the archive file (as indicated by specified parameter options). 

If LO=T (list all files processed) is specified, the listing produced is similar to that shown in figure 1-11. 
If LO=C (list all files in catalog for system) is specified, the listing produced is similar to that shown in 
figure 1-16. 
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PFATC CATALOG OF CATALOG IMAGES 
ON 76/01/14. AT 



22.07.54. 



PAGE 



19 





FILE 




NAME 


451 


Z 


452 


3DT 


453 


ADS 


454 


DEMO 


455 


FTN2 


456 


TAPE2 


457 


HRACER 


458 


AA 


459 


DSPX 


460 


B1MSAJ 


461 


BLDDIR 



USER 
INDEX 



23 
26 
26 
20 
20 
20 
25 
20 
27 
21 
27 



ACCESS 
COUNT 



2 
10 
14 
14 



2 
14 
40 
12 


32 



LAST ACCESS 
DATE TIME 



DEVICE 
NUMBER 



74/03/23. 
74/06/04. 
74/06/04. 
75/07/11. 
75/07/15. 
75/07/11. 
75/08/22. 
75/07.22. 
75/12/18. 
75/12/18. 
75/01/07. 



11. 15.23. 
09.32.26. 
09.30.04. 
16.39.20. 
11. 13.20. 
16.38.07. 
13. 19.09. 
12.26. 18. 
19.40. 17. 
12.51.34. 
16. 10.29. 



Fieure 1-16. Catalog of Catalog Imasre Record 



The two types of loads available are incremental and nonincre mental. An incremental load builds up 
(increments) an accumulation of the most recently modified versions of the files extracted from the 
archive files for loading. A series of archive files is read in the reverse order of creation. The CIR 
(refer to next section) created by the most recent incremental dump is read and checked against the 
archived files on these files. If a file matches an entry on the CIR, that file is a candidate for loading. 
A nonincremental load does no CIR checking and uses only parameter options specified on the PFLOAD 
call, if any, to select candidates for loading. 



Catalog Image Record 

Each incremental dump (OP=M) writes a catalog image record (CIR) at the beginning of the archive file 
on which the permanent files are dumped. The other types of dumps (full and partial) do not produce a 
CIR. The CIR is composed of two-word entries for every permanent file in the system at the time of the 
incremental dump (not just files included in the dump). 

The format of each entry is as follows: 



59 




41 


35 




17 





filenam 


userin 


access 
count 


dn 


date time 



filenam Name of the permanent file. 

userin User index under which filenam was cataloged. 

access count Number of times filenam was accessed. 
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dn Device number of the device on which filenam resides if it is a direct access 

file and resides on a device other than the user's master device. If it resides 
on the master device, dn=0. If the file is indirect access, dn is ignored. 

date time Date and time filenam was last accessed. 

When a file is loaded, this CIR information is placed in the permanent file catalog of the device being 
loaded. No other information can be changed over dumps and loads without updating the utility control 
date and time. 

Figure 1-16 contains a partial listing of the CIR. This listing can be obtained after a selective dump if 
the LO=C option is specified on a PFDUMP, PFLOAD, or PFATC call. A listing similar to the one in 
figure 1-11 can be obtained after a selective dump if the LO=T option is specified on a PFDUMP, 
PFLOAD, or PFATC call. In both cases, the headings vary but the format of the information is the same. 



Stages Of Checking 

Execution of the PFLOAD utility involves three stages of checking. 

• A check of the archive file to determine which files are eligible for loading (incremental loads 
only). 

• A check of the specified options in the PFLOAD call to filter out noneligible files. 

• A check of the device to be loaded to identify the files already contained on it and thereby 
determine which files from the archive file are actually to be loaded. 



Archive File Check 



The archive file check applies only to incremental loads; for nonincre mental loads this stage of checking 
is bypassed and the entire archive file to be loaded is passed on to stage 2 (specified option check). 

The usual procedure in an archive file check is as follows. The first step is to read the CIR from the 
most recent selective dump file and place it on a random file. Then the archive files are read in the 
reverse order in which they were created (the most recently created file is read first). 

Each file on an archive file is checked against the CIR on the random file for a match of file name and 
user index (these fields describe a file uniquely in the system). If a match is found, the file is a candidate 
for loading and moves to stage 2 of checking. Also, the file name and user index are zeroed out in the 
corresponding CIR entry to prevent subsequent loading of older versions of the same file. If a match is 
not found, the file is skipped because it has already been accepted for stage 2 (it appeared on a previous 
archive file and a match with the CIR was found) or has been purged. This process passes on to stage 2 
only the latest versions of files obtained from the archive files. 
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Specified Option Check 

The specified option cheek applies to those files that have passed the archive file check (incremental 
loads) and is the first stage of checking for files in a nonincremental load. Files that are candidates for 
loading are further checked against the additional restrictions specified in the parameter options of the 
P FLO AD call. Files that meet all criteria specified are passed on to the final stage (device check); all 
other files are skipped. For example, if OP=D is specified, only direct access files are candidates for 
loading. Indirect access files do not move on to stage 3. 

The specified option check also involves a check of the secondary masks of the devices to be loaded. No 
matter what parameter options are specified on the PFLOAD call, direct access files can be loaded only 
onto a device whose secondary mask allows it. That is, if the user index under which the file was created 
ends in the octal digit i, then the ith bit must be set in the secondary mask of the device onto which the 
file is to be loaded. (Refer to the definition of secondary mask.) 

The DN option on the PFLOAD call specifies the device to be loaded. If this device does not exist in the 
system or if its secondary mask forbids a file to reside on it, then such a file will be loaded onto the 
alternate (or default) device specified by the DD option on the PFLOAD call. If the DD option was not 
specified, or if the device specified by the DD option does not exist or does not have an appropriate 
secondary mask (as explained previously), then the file is not loaded and an error message is issued. 

However, in determining where to load each file, PFLOAD also checks the DN entry in the permanent 
file catalog (refer to the definition of catalog entry). Either this DN entry for a file is zero or it is 
nonzero. If DN=0, then before the file was dumped, it resided on the same device on which it was 
cataloged. If DN#0, then the file did not reside on the same device on which it was cataloged, and the 
DN entry specifies the device on which the file did reside. The following possibilities can occur. 

• If DN=0 in the PFC, then PFLOAD loads the file onto the device specified by the DN option on 
the PFLOAD call, if possible. If this load is not possible (for reasons explained previously), then 
PFLOAD loads the file onto the device specified by the DD option. If this load is not possible or 
DD was not specified, then the file is not loaded. 

• If DN=n in the PFC (n^O) and DN=n on the PFLOAD call, then PFLOAD follows the procedure 
explained in the DN=0 case. 

• If DN=n in the PFC and DN=m on the PFLOAD call (n#), m#0, and n£m), PFLOAD loads the file 
onto device n (the device specified by the DN entry in the permanent file catalog), if possible. 
If this load is not possible (for reasons explained previously), then PFLOAD loads the file onto 
the device specified by the DD option. If this load is not possible or DD was not specified, then 
the file is not loaded. 

Example: 

Files have been dumped from device 3 to archive tape AB. Device 3 no longer exists in the system; 
devices 4 and 5 do exist. The control statement 

PFLOAD(T=AB,DN=4,DD=5) 

is executed. Depending on the type of dump that was taken, some of the following types of files may not 
exist. Files that resided and were cataloged on device 3 (DN=0) are loaded to device 4 (if the secondary 
mask allows it). Files that resided on 3 but were cataloged elsewhere (DN=3) are loaded to device 5 (if 
the secondary mask allows it), because device 3 does not exist in the system. Files that were cataloged 
on 3 but resided on 4 (DN=4), are loaded to device 4 (if the secondary mask allows it). Files that were 
cataloged on 3 but resided on a device other than 3 or 4 (DN#0 and DN#4) are loaded to the device on 
which they resided (if it still exists and if the secondary mask allows it). In all cases, if the secondary 
mask does not allow the load, PFLOAD loads the file onto the alternate device, if possible; otherwise, 
the file is not loaded. 
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Device Cheek 



The device check is carried out as follows. PFLOAD determines the catalog track where the archive 
files to be loaded are to reside and builds an index file with a one-word entry for each file on the track 
The format of the entry follows. 

59 17 



filenam 


userin 



PFLOAD checks each candidate file against this entry to determine whether it is in the permanent file 
system. If it is not, the file is loaded. If it is, loading depends upon the OP=R option. If OP=R was 
specified on the PFLOAD call, the archive duplicate replaces the one in the permanent file system. If 
OP-R was not specified, archive duplicates are skipped. 



PFLOAD in a Mass Storage Subsystem Environment 

dct^ MSS environment ' an incremental load as described previously is the tvpical reload procedure. 
PFLOAD uses the CIR from the first incremental dump file to control the loading of file data and PFC 
and permit entries. Files that resided only on MSF at the time of the dum D may or may not have been 
copied to the dump tape. If OP=S was specified on the PFDUMP call, then only the PFC and permit 
n™n^ 0r J? e M ? F flleS Were included on the dum P tape. PFLOAD reloads only what was dumped by 
PbDUMP. Thus, if the file data was included on the dump tape, it will be reloaded to disk. If the file 
data was omitted from the dump tape, only the PFC and permit information for the files will be 
reloaded. Refer to section 3, Mass Storage Subsystem, for further information on how the PFLOAD 
utility is used in an MSS environment. 

EXAMPLE 

In this example, permanent files created and modified on three devices are dumped nine times The 

f™?" rUnS fr ° m March X ' 1975 (75 - 3>1) to March 10 ' 1975 (75.3.10). For simplification, the time of day 
(TM) is not shown. J 

Before the last dump, one of the devices becomes inoperable. The example then shows how this device 
can be loaded from the archive tapes. 

The following are the three devices. 

DEVICE 40 A master device containing indirect access files only. Users with this master 

device have their direct access files written on 41 or 42. 

DEVICE 41 A master device containing indirect and direct access files. Direct access files 

cataloged on this device may be written on 42 or this device. 

DEVICE 42 A nonmaster device containing direct access files only. All files written on this 

device will be cataloged on 40 or 41. 

File names consist of a letter and a number. The letter identifies which device contains the catalog 
entry for this file (A=device 40 and B=device 41). The number is the same as the device on which the file 
is written. 

Each file name is followed by a date in parentheses. This indicates either the day on which the file was 
created or when it was last modified. 

Figure 1-17 outlines the creation, modifications, and dumps that were made. There is one particular 
action per column. The top of the column identifies the action and the key parameters used by the 
utility. If an archive tape is produced, it is shown at the bottom of the column. All files in the system 
are listed in each column. Those files affected by the action are underscored. 
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Figure 1-17. PFDUMP/PFLOAD Example (Sheet 2 of 3) 
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Actions during the 10 days in March in which the dumps and modifications were made run as follows: 
Date Action 

75.3.1 Five permanent files are created on this date. 

File A40 (indirect) is written on device 40 and cataloged on device 40. 
File A42 (direct) is written on device 42 and cataloged on device 40. 
File A41 (direct) is written on device 41 and cataloged on device 40. 
File B41 (indirect) is written on device 41 and cataloged on device 41. 
File B42 (direct) is written on device 42 and cataloged on device 41. 

75.3.2 DUMP 1. A full permanent file system dump. No CIR is written on the archive file. 

75.3.3 Three files (A40, B41, and B42) are modified on this date. This is indicated by the 
modification date in parentheses following the file name. 

75.3.4 DUMP 2. This is an incremental dump of device 40 that specifies permanent files 
modified after 75.3.3. The files for this device are the ones listed on its catalog 
track. The utility scans this catalog which contains entries for files A40, A42, and 
A41. File A40 is on device 40 and the other two are on the devices indicated by 
their names. Only file A40, which was modified on 75.3.3, qualifies for this dump. 
It is written on an archive tape after a CIR for this date (75.3.4). The CIR gives a 
current description of all five files in the permanent file system. 

75.3.4 DUMP 3. This is an incremental dump of device 41 that specifies all files modified 

after 75.3.2. The catalog for this device contains entries for files B41 and B42. 
Both files were modified on 75.3.3 and qualify for this dump. They are written on an 
archive file after a CIR for this date. 

75.3.4 DUMP 4. This is an incremental dump of device 42 that specifies all files modified 
after 75.3.2. The PFDUMP utility scans the catalogs on devices 40 and 41 to locate 
the files on 42. One file, B42 (75.3.3), falls in this category. 

75.3.5 Three files are modified on this date. 

75.3.6 DUMP 5. This is an incremental dump of each of the three devices. All files 
modified after 75.3.4 are specified by the DT option. Since no DN is specified, all 
devices are dumped in turn, producing a dump tape with three archive files. 

75.3.7 DUMP 6. This incremental dump of device 42 specifies all files modified after 
75.3.4. Since 42 is nonmaster, the dump routine scans the catalogs of the other two 
devices. 

75.3.8 Four files are modified on this date. 

75.3.9 DUMP 7. An incremental dump of device 40 is made with DT=75.3.7. Two files 
qualify. 

75.3.9 DUMP 8. An incremental dump of device 41 is made with DT=75.3.7. The catalog 
on device 41 contains entries for files B41 and B42. File B41 is an indirect access 
file located on device 41, and file B42 is a direct access file located on device 42. 
Both files were modified after 75.3.7 and are dumped. 

75.3.10 DUMP 9. An incremental dump of devices 40, 41, and 42 is specified, but device 42 
becomes inoperable before the dump is made. 
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To reestablish permanent files on device 42 with the most recent modifications available, the device is 
first initialized and then incrementally loaded, beginning with the most recent incremental dump tape. 
Archive dump 8 is the most recent incremental dump tape and accordingly contains the most recent 
CIR. This reel is assigned first and then the CIR read onto a random file. The dump tapes are read in 
reverse order with each file on each tape being checked against the CIR. Dump tapes 2 and 3 are 
omitted since they do not involve device 42. 

For each catalog track on device 42 that is to receive file entries, P FLO AD builds and maintains an index 
file. Before each file can be loaded, P FLO AD checks the index file to see if the file has already been 
loaded. If it has, the archive duplicate is skipped; if not, the archive file is loaded and another entry goes 
into the index file. 

After initialization of device 42, the loading runs as follows: 

Archive File Action 



DUMP8 tape 



CIR(75.3.9) 



B4K75.3.8) 
B42(75.3.8) 



The analyst assigns DUMP8 tape and enters the command: 

PFLOAD(T=DUMP8,DN=42) 

The utility reads the CIR from this tape onto a random file. It then 
looks for files for device 42 on this tape. B42 qualifies, and its 
entry in the CIR is removed. The file B42 is loaded on device 42. 
The catalog of this file on device 41 is created. After loading this 
file, the utility makes an entry in the index file as follows: 



DUMP7 tape 



CIR(75.3.9) 



A40(75.3.8) 
A4K75.3.8) 



B42 


userin 



The utility then requests the next reel. 

The analyst assigns this tape, and the utility reads the archive file 
and checks it against the CIR loaded from DUMP8 above. No match is 
found. The next reel is requested. 



DUMP6 tape 



CIR(75.3.7) 



B42(75.3.5) 



This tape is assigned and then compared with the CIR. B42 is a file 
from device 42. However, its entry in the CIR was removed when it was 
read from DUMP8. 



DUMPS tape 



CIR(75.3.6) 



A40(75.3.5) 
B4K75.3.5) 
B42(75.3.5) 



This tape is assigned and then compared with the CIR. B42 is from de- 
vice 42 but it has already been removed from the CIR and the utility 
skips this version. 
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Archive File 



Action 



DUMP4 tape 



CIR(75.3.4) 



B42(75.3.3) 



This tape is assigned and compared with the CIR originally read from 
DUMP8 tape. It has been removed from the CIR and this file is skipped. 



DUMP1 tape 



A40(75.3.1) 



A42(75.3.1) 
A4K75.3.1) 
B4K75.3.1) 
B42(75.3.1) 



This tape, produced by a full dump, contains all the files that were 
on the permanent file system when the dump was made (75.3.1). These 
files are checked against CIR (75.3.9). A match is found with A42. 
This file is loaded. 

Device 42 now has the same files with the same update status that they 
had on 75.3.9 when the last incremental dump was made. 
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QUEUE/DAYFILE UTILITIES 



Several utility programs provide control over queued input, print, and punch files and over system, 
account, and error log dayfiles. The utility programs are divided into two groups, according to the type 
of selective processing they provide. 

• The queue file utilities are 10 utilities under the control of the queue file supervisor program 
QFSP. These utilities select for processing queue files or dayfiles that share certain 
user-specified characteristics such as device residence, origin type, and job name. 

• The dayfile dumping utilities are four independent utilities that dump all or selected parts of 
the active system, account, error log or binary maintenance dayfiles. These utilities each 
process the contents of a single file according to user-specified criteria. 



QUEUE FILE UTILITIES 

The names and functions of the queue file utilities follow. Detailed information about the call and 
operation of each utility is contained in following sections. 

Utility Description 

QREC Deactivates or activates selected I/O queue files; purges inactive queue files. 

DFTERM Terminates an active or inactive dayfile and retains it as a direct access 

permanent file. 

DFLIST Lists dayfiles that have been made permanent files by the DFTERM utility. 

QLIST Lists inactive I/O queue files. 

QDUMP Dumps I/O queue files to tape or mass storage. 

QLOAD Loads files dumped by QDUMP as I/O queue files. 

QMOVE Moves I/O queue files from one mass storage device to another. 

LDLIST Lists queue files present on a QDUMP dump tape. 

QALTER Alters routing information associated with active queued output files; purges 

active queued I/O files. 

FNTLIST Lists detailed information about active queued I/O files. 
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CALLING THE QUEUE FILE UTILITIES 

All queue file utility operations, except for DFLIST, LDLIST, and QLIST, can be initiated through console 
input to a K display. All queue utilities except DFLIST and DFTERM can be initiated through direct 
keyboard entries (under DIS or DSD control), card input (batch), or terminal entries. DFTERM and 
DFLIST operation can be initiated only through direct keyboard entries. However, in all cases, for batch 
and terminal input, the user must be validated for system origin privileges, DEBUG must be on, and the 
user must observe certain parameter order dependencies. 



Console Input 

Input from a console through a K display requires the following sequence of entries and responses. These 
procedures do not apply to DFLIST, QLIST, or LDLIST, because K displays are not available for these 
utilities. 

1. Call QFSP by typing: 

X.QFSP. 

The B display indicates the control point to which QFSP is assigned. To the right of the entry 
appears the following flashing message: 

REQUEST *K* DISPLAY 

2. Activate the K display for that control point by typing: 

K,n. (n is the control point number of QFSP specified on the B display.) 

The display shown in figure 2-1 appears on the left screen. Instructions at the bottom of the 
display describe how to select the desired utility. 



QUEUED FILE SUPERVISOR 



UTILITY DESCRIPTION 
QDUMP - QUEUED FILE DUMP PROCESSOR 
QLOAD - QUEUED FILE LOAD PROCESSOR 
QMOVE - QUEUED FILE MOVE PROCESSOR 
QREC - PROCESS QUEUED FILES. 
DFTERM - TERMINATE DAYFILES. 
FNTLIST - LIST ACTIVE QUEUED FILES. 
QALTER - ALTER ACTIVE QUEUED FILES. 



SELECT DESIRED UTILITY BY ENTERING K. OPTION 
WHERE OPTION IS ONE OF THE UTILITIES LISTED 
ABOVE. 



Figure 2-1. QFSP Display 
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3. Select the desired utility by typing: 

K.utility (utility is one of the utilities shown in the K display, figure 2-1.) 

The parameter options available under the chosen utility appear on the left screen as the initial 
K display for the utility. Figures 2-3, 2-7, 2-9, 2-12, and 2-14 exhibit initial K displays for the 
various utilities. Different parameter options are available with the different utilities. (Refer 
to Description of Queue Utility Parameters later in this section.) 

It is also possible to call each utility directly by substituting the following for steps 1, 2, and 3. 

a. Call the desired utility by typing: 

X.utility (utility is one of the utilities shown in figure 2-1.) 

The B display indicates the control point to which the chosen utility is assigned. The 
following message also appears. 

REQUEST *K* DISPLAY 

b. Activate the initial K display for the chosen utility by typing: 

K,n. (n is the control point number specified on the B display.) 

4. Several commands are available to aid in the use of the utilities and direct processing. A right 
screen display lists and defines each available command. Activate this K display by typing: 

KK. 

Figure 2-2 illustrates this queue file utility commands display. 

The following is a list of the queue file utility commands included on the display and a 
description of each. 



Command 
GO 

STOP 
RESET 



Description 

Directs the active utility to proceed with the processing of the entered 
parameters. When the processing is complete, the left-screen K display 
is reset to the default values. 

Terminates the active utility and ends the K-display interaction. 

Resets all options displayed on the left-screen K display to their default 
values. 



60455380 F 



2-3 



QUEUE FILE UTILITY COMMANDS 



THE FOLLOWING COMMANDS ARE PROVIDED- 
GO - PROCEDE WITH PROCESSING (FM MUST BE SPECIFIED). 

(ALL UTILITIES) 
STOP - TERMINATE INPUT, END RUN. (ALL UTILITIES) 
RESET - RESET PARAMETERS TO DEFAULT VALUES. 

(ALL UTILITIES) 
LIST - DISPLAY J03NAMES OF ACT I VE/ I NACT I VE QUEUED FILES 

ON RIGHT SCREEN. (QREC, DFTERM, QALTER, FNTLIST) 
+ - PAGE LIST OF JOBNAMES DISPLAYED ON RIGHT SCREEN. 

(QREC, QALTER, FNTLIST). 
CLEAR - SET RIGHT SCREEN TO THIS DISPLAY. (QREC) 

DFTERM, QALTER, FNTLIST.) 
OUT - RELEASE FILE SPECIFIED BY L PARAMETER TO 

PRINTER. (ALL UTILITIES) 
REWIND- IF ENTERED, DUMP/LOAD FILE WILL BE REWOUND WHEN 

-GO- COMMAND IS ENTERED. (QDUMP AND QLOAD ONLY). 
ERROR - TOGGLE STATUS OF ERRORED'FILE PROCESSING. 

(QDUMP, QLOAD, QMOVE ONLY). 



DA, UI, FS AND ID DIRECTIVES MAY HAVE ONE OF TWO FORMS- 

DA=YYMMDD PROCESS THIS DATE ONLY. 

DA=YYMMDD-YYMMDD PROCESS ALL DATES IN SPECIFIED RANGE. 

UI=XXXXXX PROCESS THIS USER INDEX ONLY. 

UI=XXXXXX-YYYYYY PROCESS ALL INDICES IN SPECIFIED RANGE. 

FS=XXXXXX PROCESS THIS FILE SIZE ONLY. 

FS=XXXXXX-YYYYYY PROCESS ALL SIZES IN SPECIFIED RANGE. 

IF 777777B IS SPECIFIED, ALL SIZES LARGER ARE INCLUDED. 

ID=XX PROCESS THIS ID ONLY. 

ID=XX-YY PROCESS ALL ID,S IN SPECIFIED RANGE. 



Figure 2-2. Queue File Utility Commands Display 



Command Description 

LIST If the QREC utility is active, this command displays a list of inactive I/O 

queue files on the right-screen K display (figure 2-4). The list of files 
displayed is also written on the output file specified by the QREC L 
option. 

If the DFTERM utility is active, this command displays a list of all 
permanent dayfiles (figure 2-8). The list of files displayed is also written 
on the output file specified by the DFTERM L option. 

If the QALTER or FNTLIST utility is active, this command displays a list 
of active I/O queue files on the right-screen K display (figure 2-18). The 
list of files is also written on the output file specified by the QALTER or 
FNTLIST L option. 
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Command Description 

LIST=fnt Displays detailed information about the active I/O queue file at FNT 

ordinal fnt on the right-screen K display and writes the information to 
the output file specified by the Q ALTER or FNTLIST L option. This 
form of LIST is accepted only by QALTER and FNTLIST. 

+ Used in conjunction with the LIST command and displays succeeding 

pages (screens) of the information listed. This command applies only to 
the QREC, QALTER, and FNTLIST utilities. 

CLEAR Used in conjunction with the LIST command and returns the right-screen 

K display to the list of processing commands initially displayed (figure 
2-2). 

OUT Disposes the output file specified by the L option of each utility to the 

print queue for immediate printing. Any information that has been or is 
currently displayed on the right-screen K display via the LIST command 
is also included with the disposed output. In addition, if the LIST 
command is currently active, the list displayed on the right screen is 
disposed, and the initial right-screen K display shown in figure 2-2 is 
returned automatically. 

REWIND Rewinds the load or dump file specified by the FN option before 

processing. This command applies only to the QLOAD and QDUMP 
utilities. 

ERROR If the QDUMP utility is active, enabling this command causes files on 

which unrecoverable read errors were encountered to be dumped with the 
errors listed on the output file. Disabling this command causes these 
files to be ignored. The default under QDUMP is enabled. 

If the QLOAD utility is active, enabling this command causes such files 
to be loaded with the errors listed on the output file. Disabling the 
command causes such files to be ignored. The default under QLOAD is 
disabled. 

If the QMOVE utility is active, enabling this command causes such files 
to be moved with errors listed on the output file. Disabling this 
command causes such files to be ignored. The default under QMOVE is 
disabled. 

The entry of this command toggles the setting of this command. 

5. Select the desired parameter options by typing: 

K.opt 1 =val 1 ,opt 2 =val 2 ,...,opt n =val n 

where the optpvalj are selected from the parameter option list on the initial K display for the 
chosen utility. 

The option parameter entries are issued to the control point dayfile, which is included in the 
output file specified by the L option for each utility (refer to Parameters). 
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If the FM option is specified for QREC, QDUMP, or QMOVE (indicating the processing of queue 
files for only the specified family of devices), the initial left screen display (figures 2-3, 2-9, 
and 2-14) is replaced by the secondary left screen display (figures 2-5, 2-10, and 2-15). This 
display closely resembles the initial left screen for the utility but restricts processing to the 
family of devices specified. Each device in the specified family containing inactive queue files 
is indicated. In addition, any option entered for the utility is reflected in this display. Options 
not entered remain at default values. 

If the FM option is not specified, the initial K display remains on the left screen. However, the 
display is modified to reflect the parameter options entered. Options not entered remain at the 
default values. 

The displays are modified in this manner to provide an opportunity to double-check the entry. If 
it is necessary to modify the entry, reenter those options that are to be changed. Entry of 
illegal data causes an error message to appear at the bottom of the left-screen K display. In 
this case, the portion of the entry up to the point where the error was encountered is processed; 
the remainder of the entry (from left to right) is ignored. 

6. Initiate execution by typing: 

K. GO. 
When processing is complete, the left-screen K display is reset to default values, the message 

option COMPLETE (option is the name of the utility processed) 

appears at the bottom of the screen, and the right screen returns to the original display. 

7. Terminate use of the chosen utility and end K-display interaction by typing: 

K.STOP 

An output file is generated indicating the disposition of I/O queue files or dayfiles processed. 
Examples of output files generated by each utility are shown in figures 2-6, 2-8, 2-11, 2-13, and 
2-16. 

It is also possible to call each utility and specify appropriate options without the use of K displays; this is 
the only way to call DFLIST. This is accomplished via a single keyboard entry in the following format. 

X.utility(opt 1 =val 1 ,opt 2 =val 2 ,...,opt n =val n ,I=filenam,NK) 

utility Any I/O queue or dayfile utility. 

optj=vali Parameter options (refer to Parameters for the Queue File Utilities). 

I=filenam Name of alternate input file (optional). This file may contain K display 

utility commands (GO, STOP, RESET, and so on) and/or valid option 
parameters. 

NK Specifies that no K-display input is allowed. The use of the NK parameter 

and proper parameter selection allows the utility to run without additional 
operator intervention. This parameter is not needed and should not be 
entered for QLIST, LDLIST, and DFLIST. 
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The specified utility processes parameter options on the control statement before the alternate input 
file, if any. If the utility is QLIST, LDLIST, or DFLIST or if NK is specified, the requested queue/dayfile 
processing proceeds after all control statement and/or alternate input file parameters have been 
processed (unless a STOP command is encountered on the alternate input file). If NK is omitted from the 
control statement and the utility is not one previously mentioned, the utility requests the K display after 
processing the control statement and alternate input file (unless a STOP command is encountered on the 
alternate input file). The K display then reflects the status of all parameter options after processing of 
the control statement and alternate input file is complete. If the utility encounters an error while 
processing the control statement or alternate input file, a request for the K display appears on the DSD B 
display (except for QLIST, LDLIST, and DFLIST). The operator may then activate the K display, enter 
the correct parameter options, and continue processing. However, if errors are encountered and the 
utility was invoked by a nonsystem origin job, a message is issued to the dayfile, and utility processing is 
terminated. 

Batch Input 

To call the utilities from a batch job, the user must be validated for system origin privileges, and DEBUG 
must be set at the system console. The following deck structure is used to call a utility. 

Job statement 

USER statement 

CHARGE statement (if necessary) 

utility(opt 1 =vai 1 ,opt 2 =val2,...,opt n =val n ,I=fUenam,NK) 

utility Any of the following I/O queue or dayfile utilities: QREC, QDUMP, QLOAD, 

QMOVE, QLIST, LDLIST, QALTER, or FNTLIST. 

optj=valj Parameter options (refer to Parameters for the Queue File Utilities). 

I=filenam Name of alternate input file (optional). This file may contain K display utility 

commands (GO, STOP, RESET, and so on) and/or valid option parameters. 

NK Specifies that no K-display input is allowed. The use of the NK parameter and 

proper parameter selection allows the utility to run without additional operator 
intervention. This parameter is not needed and should not be entered for QLIST or 
LDLIST. 

The DFLIST and DFTERM utilities cannot be called from a batch job. They must be initiated from the 
system console. 

Terminal Input 

The format of terminal input for calling the queue utilities is substantially the same as that for batch 
input. The user must be validated for system origin privileges, and DEBUG must be set at the system 
console. At login, the user enters the batch subsystem, calls the desired utility, and enters the 
appropriate parameters with the command 

utility(opti=val 1 ,opt 2 =val2,...,opt n =val n ,I=filenam,NK) 

The utility, opt=val, I=filenam, and NK parameters are as described for batch input. 

PARAMETERS FOR THE QUEUE FILE UTILITIES 

Table 2-1 indicates the parameter options accepted by each queue file utility. (DFLIST is not included 
because it does not accept any parameters.) An X indicates that a parameter option is accepted; a blank 
indicates that a parameter option is not accepted. Refer to the following descriptions of parameters for 
more information. 
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TABLE 2-1. QUEUE FILE UTILITY PARAMETER OPTIONS 



Parameter 




Utility 


QREC 


ODUMP 


QLOAD 


QMOVE 


OALTER 


LDLIST 


FNTLIST 


DFTERM 


QLIST 


BC 


X 


X 


X 


X 


X 


X 


X 




X 


DA 


X 


X 


X 


X 




X 






X 


DD 






X 


X 




X 








DF 






X 


X 


X 


X 


X 






DN 


X 


X 




X 


X 




X 


X 


X 


DS 


X 


X 


X 


X 


X 


X 


X 




X 


EI 


X 


X 


X 


X 


X 


X 


X 




X 


FC 


X 


X 


X 


X 


X 


X 


X 




X 


FM 


X 


X 




X 


X 




X 


X 


X 


FN 




X 


X 






X 








FS 


X 


X 


X 


X 




X 






X 


FT 
















X 




FU 


X 


X 


X 


X 




X 






X 


ID 


X 


X 


X 


X 


X 


X 


X 




X 


JC 










X 




X 






JN 


X 


X 


X 


X 


X 




X 




X 


L 


X 


X 


X 


X 


X 


X 


X 


X 


X 


LO 










X 




X 






ME 




X 


X 






X 








MI 


X 


X 


X 


X 




X 






X 


NDF 










X 










NF 




X 


X 






X 








NFC 










X 










NID 










X 










NM 
















X 




NPR 










X 










NRC 










X 










NUN 










X 




- 






OP 


X 




X 


X 


X 






X 




sc 






X 






X 








SY 


X 


X 


X 


X 




X 






X 


TID 


X 


X 


X 


X 




X 






X 


TP 




X 




X 












UI 


X 


X 


X 


X 




X 






X 


UN 










X 




X 






VSN 


.-„ 


X 


X 






X 
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Description of Queue Utility Options 



DA=yymmdd 



DD=dn 



DF=family 



DN=dn 



Processing data in the form of year, month, day. If one date is specified, only I/O 
queue files created on that day are processed. If two dates, separated by a 
hyphen, are specified (for example, 780530-780613), all queue files created within 
the specified range (including the end points) are processed. If this option is 
omitted with utilities other than QLIST, queue Hies created 5 days prior to the 
current date are processed. If this option is omitted with QLIST, all inactive 
queue files, regardless of creation date, are processed. 

Destination device to which files are to be loaded or moved. The DF option must 
be specified before the DD option. If DF is specified, DD must also be specified. 
With QMOVE, both DD and DF must be specified. 

Family of devices to which files are to be loaded or moved. With QMOVE, this 
option must be specified. 

With QALTER or FNTLIST, DF must be used with the UN option. The utility will 
process files belonging to the remote terminal identified by these options. 



One- or two-digit device number (1 through 77 g). With utilities other than 
DFTERM, this option specifies the device to be processed, dumped, or loaded. 

pQlll'f io oil /Ininnnti 



The FM ontion must hp srv>f»ifi*»H hofnno tho nw rtr»+;r>n nzvPquH- 



With DFTERM, this option specifies the device on which the inactive dayfile 
resides or on which the new dayfile will reside if the active dayfile is terminated. 
Default is the device on which the current dayfile resides. 
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DS=dv-ex or DS=dv Device selection criteria for output files. The types of output devices (dv) that 
can be selected include the following. 

dv Description 



LR 580-12 printer 

LS 580-16 printer 

LT 580-20 printer 

NONE No device code specified 

PB Punch binary 

PL Plotter 

PR Any printer 

PU Punch coded 

P8 Punch 80 column 

SB Punch system binary 

The external characteristics (ex) of the device are optional and can be any of the 
following. 

For print files: 

A4 Provided for NOS/BE compatibility 

A6 ASCn graphic 63/64-character set 

A9 ASCII graphic 95-character set 

B4 Provided for NOS/BE compatibility 

B6 CDC graphic 63/64-character set 
For punch files: 

ASCE Punch ASCn 

026 Punch 026 mode 

029 Punch 029 mode 

PU Punch coded 

SB Punch system binary 

80COL Punch 80-column binary 
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FC=fc 



FM=family 



FN=filenam 



FS=x 



Forms code for print and punch files considered for processing. With utilities 
other than QALTER and FNTLIST, fc can be any of the following. 



fc 
Ax 



NULL 
ALL 



Description 

x is any character from A through F. Files with this forms code 
are considered for processing. 

Files with forms codes in the range AG through 99 are considered 
for processing. 

Files without forms codes are considered for processing. 

All files are considered for processing regardless of forms codes. 



With QALTER and FNTLIST, fc can be any of the following. 



fc 

fci 

fci/fc 2 

fci/fc2/fc3 



fci-fc 2 



Description 

fcj is two alphanumeric characters or **, 
indicating null forms code. Up to three forms code 
or ** can be specified; files with the specified 
forms code(s) are considered for processing. 

fcj is two alphanumeric characters or **. If 
fci is not **, the display code value of fc^ 
must be less than or equal to the display code 
value of fc2. fe 2 can be ** only if fci is 
also **. Files in the range fcj through fc 2 
are considered for processing; if fci equals **, 
files with no forms code are (also) considered for 
processing. 

A subsequent FC entry replaces any FC entry previously made. Default is to 
consider all files for processing regardless of forms codes. 

Name of family to be processed. Default is to process all queue files on all 
devices in all families. 

With DFTERM, this option specifies the family of devices on which the inactive 
dayfile resides or on which the new dayfile will reside if the active dayfile is 
terminated. If an active dayfile is terminated, default is the same family as that 
in which the dayfile being terminated resides. 

File name of dump or load file, which resides on magnetic tape or mass storage 
depending on the ME option. Default is FN=QFILES. 

File size in PRUs, divided by 10g. The value can be entered as a single file size 
(FS=100) or as a range of file sizes (FS=10-400). x <777777g. 



60455380 D 



2-11 



FT=t 



FU=family 



ID=id 



JC=name 



JN=jobnam 



L=filenam 



LO=opt 



Type of dayfile to be terminated by the DFTERM utility, 
t Description 



ACCOUNT 
DAYFILE 
ERRLOG 
MAINLOG 



Account dayfile 

System dayfile 

Error log dayfile 

Binary maintenance log dayfile 



This option causes the FM and DN options to be updated to reflect the current 
family and device number of the dayfile specified by FT. Default is FT=DAYFILE. 

Name of family under which the queue files to be processed were created. Queue 
files created by users of one family can reside on nonremovable devices of another 
family. The FM option specifies the family of devices that will be searched for 
I/O queue files created by users validated in the family specified by the FU 
option. Default is to process queue files created by users in all families. 

One- or two-digit octal number (0 through 77g) specifying that only local batch or 
system origin queue files assigned that identifier are to be processed. If two 
identifiers, separated by a hyphen, are specified (for example, ID=6-30), any queue 
file with identifier in the specified range (including the end points) is processed. 
Default is to process all queue files regardless of identifier. 

One- to seven-character name specified on job statements associated with queue 
files being listed or altered. Only one name can be specified. A subsequent JC 
entry replaces any JC entry previously made. This option in conjunction with the 
JN option uniquely describes which files are to be processed. 

Seven-character job name or four-character banner name (first four characters of 
job name) of I/O queue files to be processed, dumped, loaded, or moved. At most, 
five job names can be specified. If a job name is specified more than once, it is 
removed from the list. If fewer than seven characters are specified, all queue 
files that have identical job names are processed. Default is to process all queue 
files regardless of job/banner names. 

One- to seven-character name of the file to receive output. Default is 
L=OUTPUT. 

List option associated with the output file specified by the L option. 

opt Description 



All routing information for each file. 
Condensed listing of each selected queue file. 
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ME=x 



MI=id 



Medium from which to load or to which to dump. 
x Description 

MS Mass storage device. 

MT Seven-track tape. 



NT 



Nine-track tape. 



If MT or NT is specified, a request for a magnetic tape is issued and all selected 
queue files are loaded from or dumped to that tape. If the tape is not preassigned, 
the installation default density for the specified track type is used. Default is 
that the installation default track type and density are used. 

One- or two-character machine identifier indicating the mainframe on which the 
queue files to be processed currently reside. If MI=ALL is specified, any queue file 
residing on any mainframe is processed. The MI entry is cleared if previously 
specified; that is, specifying two identical MI entries is the same as not specifying 
any at all. If the MI entry is cleared on the K display, the id is not checked. 
Default is machine identifier of the mainframe where the utility is being run. 



NOTE 



The MI directive should be cleared before queued files 
created on a premultimainframe system (NOS 1.0) are 
processed. This is required because of the addition of 
the MI directive for use in multimainframe systems. 



NDF=family 



NF=n 



NFC=fc 



New destination family name associated with selected print or punch files. This 
option is meaningful only in the altering of files whose origin type is or is being 
changed to remote batch. A subsequent NDF entry replaces any previous NDF 
entry. Default is no change in destination family name. 

Decimal number of media files to skip. A media file contains all queue files which 
are dumped by one QDUMP operation. Each of these dumped queue files exists as 
a record on the media file. If two QDUMP operations are performed, the dumped 
queue files exist as records on two files. This option can be used in conjunction 
with the SC option. Default is 0. 

Two alphanumeric characters or ** (null forms code) specifying the new forms 
code associated with selected print or punch files. The NFC entry is cleared if 
previously specified; that is, specifying two identical NFC entries is the same as 
not specifying any at all. Default is no change in forms code. 
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NID=id 



NM=filenam 



NPR=p 



NRC=c 



NUN=usernum 



OP=opt 



One- or two-digit number (0 through 67 8 ) specifying the new file identifier 
associated with selected print or punch files. This option is meaningful only in the 
altering of files whose origin type is or is being changed to remote batch. The 
NID entry is cleared if previously specified; that is, specifying two identical NID 
entries is the same as not specifying any at all. Default is no change in file 
identifier. 

One- to five-character name of the direct access permanent file on which 
DFTERM writes the terminated dayfile. DFTERM adds a two-character prefix 
indicating the type of dayfile being terminated (AC, DF, or ER). Default is 
automatic naming of the file by DFTERM according to the following. 

• The first two characters indicate the type of dayfile being terminated 
(AC, DF, or ER). 

• The third character is a sequence number (A through 9). 

• The next two characters indicate the month. 

• The last two characters indicate the day of the month. 

One- to four-digit number (0 through 7777g) specifying the new priority associated 
with selected print or punch files. The NPR entry is cleared if previously 
specified; that is, specifying two identical NPR entries is the same as not 
specifying any at all. Default is no change in file priority. 

One- or two-digit number (0 through 37 g) specifying the new repeat count 
associated with selected print or punch files. The NRC entry is cleared if 
previously specified; that is, specifying two identical NRC entries is the same as 
not specifying any at all. Default is no change in repeat count. 

New destination user number associated with selected print or punch files. This 
option is meaningful only in the altering of files whose origin type is or is being 
changed to remote batch. The NUN entry is cleared if previously specified; that 
is, specifying two identical NUN entries is the same as not specifying any at all. 
Default is no change in destination user number. 

Processing option specifying the function to be performed by each utility. 

With QREC, opt can be any of the following. Default is OP=RI. 

opt Description 

DI Selected active I/O queue file are made inactive (entries 

are removed from the FNT and added to the IQFT file), 
and the remaining active queue files are ignored. 



PI 



Selected inactive I/O queue files are purged, and the 
remaining inactive queue files are ignored. 
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opt Description 

RI Selected inactive I/O queue files are activated 

(requeued), and the remaining inactive queue files are 
ignored. 

RP Selected inactive I/O queue files are activated 

(requeued), and the remaining inactive queue files are 
purged. 

With QALTER, opt specifies the origin type to which the selected queued files 
should be changed, and can be one of the following. Default is OP=NC. 

opt Description 



BC Change to local batch. 

EI Change to remote batch. 

NC Do not change origin type. 

PR Purge files. 

With DFTERM, opt specifies whether active or inactive dayfiles will be 
terminated. With QLOAD and QMOVE, opt specifies whether the loaded or moved 
queue files will be active or inactive. With these utilities, opt can be one of the 
following. Default is OP=A. 

opt Description 

A Active queues/dayfiles are specified. 

I Inactive queues/dayfiles are specified. 

ot=ft Job origin type (ot) and corresponding file type (ft) to be processed. 

ot can be one of the following (successive ot entries are allowed). 

ot Description 

BC Local batch and system origin for QALTER and FNTLIST 

and local batch origin for all other applicable utilities. 

EI Remote batch origin. 

SY System origin; cannot be used with QALTER or FNTLIST. 
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ft can be one of the following. 

ft Description 



ALL Files of all types for specified origin type. 

IN Input files. 

NONE No files for specified origin type. 

PH Punch files. 

PR Print files. 

SF Installation-defined special files; cannot be used with 

QALTER or FNTLIST. 

Origin type parameters (ot) can be entered more than once, with each successive 
entry reversing the previously established condition. Initially, all origin types and 
all file types are selected; thus any entry actually clears the automatic selection. 
For example, BC=PH would indicate that local batch origin punch files are not to 
be processed. However, a second BC=PH selection would reenable processing of 
local batch origin punch files. 

If ALL or NONE is specified for ft, processing of all queue file types for the 
specified origin type is either enabled or disabled, respectively. If all file types 
are currently enabled for a particular origin type, entering ALL would have no 
effect. Likewise, entering NONE when all file types for a particular origin type 
are disabled would have no effect. 

sc=n Decimal number of queue files (and hence records on the dump file) to be skipped 

before the queue selection begins. Skipping begins at the point on the dump file 
indicated by the NF option. This option allows a restart load to begin from the 
last aborted queue loaded by QLOAD. Default is SC=0. 

TID=id 0n e- to six-digit value plus a radix which specifies the destination terminal 

identifier for remote batch origin output files. If TID=0, no terminal identifier is 
specified. Default is TID=0. 

TP=t Type of files to move or dump. 

t Description 



A Active files. 

ALL Active and inactive files. 

I Inactive files. 

Default is TP=ALL. 

UI=userin User index under which I/O queue files to be processed were created. If two user 

indexes, separated by a hyphen, are specified (for example, 75-162), all queue files 
created by all users having indexes within this range (including the end points) are 
processed. Default is to process all queue files regardless of user index. 
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UN=usernum Destination user number within the family specified by the DF option. UN and DF 

must be specified together. The utility (QALTER or FNTLIST) wiU process files 
belonging to the remote terminal identified by these options. 

VSN=vsn Volume serial number of the tape to dump to, load from, or list. This entry is 

ignored if ME=MT or ME=NT is not specified. 



NOTE 



If the currently displayed value for NFC, NID, 
NPR, NRC, NUN, or UN is reentered, the value 
for the specified option is cleared. 



File Preassignment 



In the QDUMP and QLOAD utilities, consideration should be given to file preassignment. The type, 
density, and vsn of the file (tape) can be specified with the utility options ME and VSN. These attributes 
can also be specified when the file is assigned to a control point. The relation between file 
preassignment and the specification of the ME and VSN parameters is shown in the following eases. 



• 



• 



If the file specified by the FN option (or the default file QFILES) has been assigned to a control 
point prior to the utility call, that file is used as the dump or load file. In this case, the ME and 
VSN attributes are ignored if specified. For example, file assignment and the utility call are 
made with the following statements. 

LABEL(QFILES,VSN=DMP1,D=HY) or ASSIGN(MS,QFILES) 
QDUMP(ME=NT,VSN=DUMPF) QDUMP(ME=NT,VSN=DUMPF) 

The file QFILES is already at a control point when the utility is called. The utility does not 
make a tape request, and ME and VSN are ignored. 

If no file preassignment was done, the operator is requested to assign the unit to be used with 
the attributes specified by the ME and VSN options. For example, the following statement is 
issued. 

QDUMP(ME=NT,VSN=DUMPF) 

The operator is requested to assign a unit with attributes as specified by the ME and VSN 
options. If the operator assigns a tape unit, the installation default density for the specified 
track type is used. If ME is not specified and no file preassignment is done, the installation 
default track type and density are used. 

A file name should not be associated with the tape vsn (via the VSN control statement) unless the tape is 
assigned (via the LABEL control statement). If this is done prior to a utility call, QLOAD or QDUMP will 
abort. 
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Active And Inactive Queue Files 

An I/O queue file can be active or inactive. All queue- files are originally active upon entering a queue. 
A queue file is deactivated (made inactive) when its entry is removed from the file name table (FNT) and 
a corresponding entry is created in an inactive queue file table (IQFT) file. An IQFT file is on each mass 
storage device on which one or more inactive queue files reside. An inactive queue file is activated when 
the entry from the IQFT file is removed and a corresponding entry is created in the FNT. Inactive queue 
files are not considered for processing (other than by the queue utilities), nor do they appear on any DSD 
display. 

Three queue file utilities can deactivate or activate queue files (QLOAD, QMOVE, and QREC). QLOAD 
and QMOVE each transfer queue files from either tape or mass storage to a mass storage device. Upon 
completion of the transfer, the utility leaves the queue files active or inactive according to parameters 
specified by the analyst or operator. QREC does not perform any file transfer but only adjusts table 
entries as described in the preceding paragraph. These three utilities have uses other than deactivation 
and activation of queue files (refer to the description of the appropriate utility and parameter options). 

Queue files are also deactivated when they are recovered during a level deadstart. Such files can be 
activated automatically by an IPRDECK entry that invokes QREC during a level deadstart. Refer to 
the NOS Installation Handbook for further information on IPRDECK. 



QUEUE FILE UTILITY ROUTINES 

This section describes the queue file utility routines. The parameter options available for each of the 
routines are listed in table 2-1. The K displays (if any) for each utility are illustrated. These displays 
contain lists of applicable parameter options and the output formats for each utility. 



QREC 

QREC deactivates or activates selected I/O queue files and purges selected inactive queue files. 

When QREC is selected at the system console, the initial QREC K display appears on the left screen. 
This display contains a list of all applicable options associated with QREC, their default values, and a 
short description of each (figure 2-3). 

A complete list of current inactive I/O queue files is displayed on the right screen when the following 
command is entered: 

K.LIST. 

When this command is processed, the right-screen K display is automatically replaced with the inactive 
queues K display (figure 2-4). The information presented in this display is the same as that generated by 
the QLIST utility. The list of files displayed is also written to the output file specified by the QREC L 
option. 
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""" QUEUED FILE REQUEUING :::::; 
INACTIVE QUEUES RESIDE ON FOLLOWING F AMI L I E S( :c = BLANK NAME) 



OPTIONS 
MI = 72 
FM = ALL 
DN = ALL 
FU = ALL 
UI = OB 

377777B 
DA = 78/04/10. 

78/04/15. 
FS = OB 

777777B 
JN = 



ID = 


OB 




77 


TID = 


OB 


FC = 


AL 


DS = 




L = 


OU 


OP = 


RI 



TPUT 



RP 
RI 
PI 
DI 



(OT=FT) 



S I P P 
F N H R 



BC 
EI 
SY 



DESCRIPTION 
MACHINE ID (1-2 CHARACTERS , ALL). 
FAMILY FOR DEVICES (1-7 CHARACTERS). 
DEVICE NUMBER (1-77B, ALL). 
FAMILY FOR USER INDEX (1-7 CHARACTERS). 
USER INDEX RANGE (0-377777B). 

QUEUED DATE RANGE (YYMMDD) . 

FILE SIZE RANGE IN PRUS/10B (0-777777B) 

JOBNAMES (4 OR 7 CHARACTERS). 
JOBNAME WILL BE CLEARED IF 
PREVIOUSLY ENTERED. 



ID OF FILES TO PROCESS (0-77B). 

DESTINATION TID (0-377777B). 

FORMS CODE. 

DEVICE SELECTION FOR OUTPUT FILES. 

FILE TO RECEIVE OUTPUT (1-7 CHARACTERS). 

PROCESS OPTION (2 CHARACTERS). 

- SELECTION SPECIFIED FILES, PURGE OTHERS 

- REQUEUE SPECIFIED FILES, IGNORE OTHERS. 

- PURGE SPECIFIED FILES, IGNORE OTHERS. 

- DEQUEUE SPECIFIED FILES, IGNORE OTHERS. 

REQUEUE BY ORIGIN TYPE AND FILE TYPE. 
OPTION WILL BE CLEARED IF PREVIOUSLY 
SELECTED. - = OPTION SELECTED. 
OT=ORIGIN TYPE FT=FILE TYPE 

BC-BATCH SF-SPECIAL PH-PUNCH 
EI-EXPORT IN-INPUT PR-PRINT 
SY-SYSTEM 



Figure 2-3. Initial QREC Display 
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END OF 







:c :c :c 


INACTIVE 


QUEUES LIST " J::: 




















LENGTH 


0. 


FILENAME 


MID 


FAMILY 


DN 


FT 


OT 


DATE (PRUS/10) 


1. 


QISOAOW 


72 


SYS172 


1 


PR 


SY 


78/03/31. 


16 


2. 


QISOAOR 


72 


IAFFAM 


1 


PR 


BC 


78/03/31. 


17 


3. 


QISOAOR 


72 


IAFFAM 


1 


PR 


SY 


78/03/31. 


21 


4. 


IAF 


72 


SYS172 


1 


PR 


SY 


78/03/31. 


4 


5. 


DISOAHJ 


72 


SYS172 


1 


PH 


BC 


78/03/31. 


1 


6. 


DISOAHJ 


72 


SYS172 


1 


PR 


BC 


78/03/31. 


1 


7. 


QI50AUT 


72 


SYS172 


2 


PH 


SY 


78/03/31. 


7 


8. 


IAF 


72 


SYS172 


2 


PR 


SY 


78/03/31. 


4 


9. 


DISOAHJ 


72 


SYS172 


2 


PR 


BC 


78/03/31. 


2 


DISPLAY. 

















Figure 2-4. Inactive Queues List 



If the FM option is specified, indicating processing of queue files for a specified family of devices, the 
initial QREC left-screen K display is replaced by the secondary QREC K display (figure 2-5). This 
display closely resembles the initial QREC display but restricts QREC processing to the family of devices 
specified. Each device in the specified family containing inactive queue files is indicated. In addition, 
any option entered for the QREC utility is reflected in this display. Options not entered remain at 
default values. 

After QREC processing has been completed and K-display interaction has been terminated by 
K.STOP. 

an output file is generated, indicating the disposition of all I/O queue files processed. Figure 2-6 
contains an example of this output. 

Example 1: 

If the FNT is becoming full, the analyst can enter QREC from DSD to dequeue active queue files and 
free up FNT space. The following QREC entry dequeues all queue files. 

X.QREC(OP=DI,NK) 

If EI200 or RBF is not active, the analyst is still able to dequeue remote batch origin files by using 
QREC. The following QREC entry dequeues all remote batch files. 

X.QREC(OP=DI,BC=NONE,SY=NONE,NK) 

If these are queue files that previously had been dequeued, the analyst can activate these files with 
QREC. The following QREC entry requeues all inactive queue files. 

X.QREC(OP=RI,NK) 
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:{:c " QUEUED FILE REQUEUING " :::: 

INACTIVE QUEUES RESIDE ON FOLLOWING DEVICES IN FAMILY - SYST72 
01 02 03 



OPTIONS 
MI = 72 
FM = SYST72 
DN = ALL 
FU = ALL 
UI = OB 

377777B 
DA = 78/04/10 

78/04/15 
FS = 0B 

777777B 
JN = 



ID = 

TID = 

FC = 
DS = 
L = 
OP = 



0B 
77B 
0B 
ALL 

OUTPUT 
RI 



RP 
RI 
PI 
DI 



(OT=FT) 



I P P 
N H R 



BC 
EI 
SY 



DESCRIPTION 
MACHINE ID (1-2 CHARACTERS). 
FAMILY FOR DEVICES (1-7 CHARACTERS, ALL). 
DEVICE NUMBER (1-77B, ALL). 
FAMILY FOR USER INDEX (1-7 CHARACTERS). 
USER INDEX RANGE (0-3777778). 

QUEUED DATE RANGE (YYMMDD). 

FILE SIZE RANGE IN PRUS/10B (0-777777B). 

JOBNAMES (4 OR 7 CHARACTERS). 
JOBNAME WILL BE CLEARED IF 
PREVIOUSLY ENTERED. 



ID OF FILES 



TO PROCESS (0-77B) 
TID (0-377777B). 



DESTINATION 

FORMS CODE. 

DEVICE SELECTION FOR OUTPUT FILES. 

FILE TO RECEIVE OUTPUT (1-7 CHARACTERS). 

PROCESS OPTION (2 CHARACTERS). 

- SELECTION SPECIFIED FILES, PURGE OTHERS 

- REQUEUE SPECIFIED FILES, IGNORE OTHERS. 

- PURGE SPECIFIED FILES, IGNORE OTHERS. 

- DEQUEUE SPECIFIED FILES, IGNORE OTHERS. 

REQUEUE BY ORIGIN TYPE AND FILE TYPE. 



OPTION WILL ! 
SELECTED. « 
OT=ORIGIN TYPE 
BC-BATCH 
EI-EXPORT 
SY-SYSTEM 



E CLEARED IF PREVIOUSLY 

= OPTION SELECTED. 

FT=FILE TYPE 
SF-SPECIAL PH-PUNCH 
IN-INPUT PR-PRINT 



Figure 2-5. Secondary QREC Display 
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QREC/QLIST PROCESSOR. 78/04/20. 10.36.43. PAGE 1 

-"" QUEUE DISPOSITION :::: " 

LENGTH 
NO. FILENAME MID FAMILY DN FT OT DATE (PRUS/10) DISPOSITION 



1 . 


QISOAAH 


72 


SYS172 


2 


PR 


EI 


78/04/20. 


33 


ACTIVATED 


2. 


QISOAAH 


72 


SYS172 


2 


PR 


BC 


78/04/20. 


5 


ACTIVATED 


3. 


QISOAAH 


72 


SYS172 


3 


PH 


EI 


78/04/20. 


26 


ACTIVATED 


4. 


DISOAAM 


72 


SYS172 


3 


PR 


SY 


78/04/20. 


3 


ACTIVATED 



Figure 2-6. QREC Output File 



Example 2: 

The analyst can purge all queue files (active and inactive) on a particular device by using QREC either 
with or without an input directive file. The first method involves two control statement calls to QREC. 
The first QREC call dequeues (makes inactive) all active files on the device with family name SYSTEM 
and device number 1, and the second QREC call purges all inactive (and hence all) queue files on that 
same device. 

QREC(NK,OP=DI, FM=SYSTEM,DN=1) 
QREC(NK,OP=PI, FM=SYSTEM,DN=1) 

The second method involves only one control statement call to QREC to perform the same function as 
the first method does. 

QREC(I=DIR) 

File DIR is the input directive file which contains the following directives. 

OP=DI,FM=SYSTEM,DN=l. 

GO. 

OP=PI, FM=SYSTEM,DN=1 

GO,STOP. 

Example 3: 

This example exhibits the relationships among the ID, TID, and FC parameter options. It is important to 
note the following restrictions regarding these parameters and QREC. 

• ID pertains only to local batch and system origin output files. 

• TID pertains only to remote batch origin output files. 
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• FC pertains to all output files. 

• When the OP option is specified, all I/O queue files are processed unless the ID, TID, and FC 
parameters restrict output file selection or the ot=ft option restricts input or output file 
selection. 

The following control statement activates all local batch and system origin output files with ID=6 and 
FC=AD, all remote batch origin files with TID=3751 and FC=AD, and all input files. 

QREC(NK,OP=RI,ID=6,TID=3751,FC=AD) 

The following control statement performs the same functions as the previous statement does except that 
no input files are processed. 

QREC(NK,OP=RI,ID=6,TID=3751,FC=AD,SY=IN,BC=IN,EI=IN) 



DFTERM 

DFTERM terminates an active or inactive dayfile and retains it as a direct access permanent file for 
later interrogation or processing. When an active dayfile (that is, the current system, account, error log, 
or binary maintenance log dayfile) is terminated, information in the central memory buffer for that 
dayfile is written to mass storage to be included with the permanent file, and a new active dayfile is 
started. The new dayfile can reside on the same device, or a new device can be specified. 

Terminating an inactive dayfile has no effect on the currently active dayfiles. Inactive dayfiles are not 
used by the system. Furthermore, the presence of an inactive dayfile in the system is possible only under 
unusual conditions. For example, if the system is deadstarted and the device which previously contained 
the account dayfile is turned off, a new account dayfile is started on another device. Two devices in the 
system now contain account dayfiles. If both devices are turned on when the system is next deadstarted, 
two account dayfiles are recovered. The most recent account dayfile is made active and is used by the 
system. The remaining account dayfile is made inactive. 

The DFTERM utility can be initiated only from the system console through a K display or directly 
through the control statement. No batch or terminal input is allowed. 

When DFTERM is selected at the system console, the DFTERM K display appears on the left screen. 
This display contains a list of all applicable options associated with DFTERM, their default values, and a 
short description of each (refer to figure 2-7). 

A list of the permanent dayfiles is displayed on the right screen when the following command is entered. 

K.LIST. 

When this command is processed, the right-screen K display is automatically replaced with the dayfile 
list K display (figure 2-8). The information presented in this display is the same as that generated by the 
DFLIST utility. 
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:;:c:c DAYFILE T 


DAYFILES- 






TYPE 


FAMILY 


DN 


DAYFILE 


SYST72 


IB 


ACCOUNT 


SYST72 


IB 


ERRLOG 


SYST72 


IB 


MAINLOG 


SYST72 


IB 



INACTIVE DAYFILES- 

TYPE FAMILY 



DN 



OPTIONS 
FT = DAYFILE 

FM = SYST72 

DN = IB 



OP = A 

NM = 

L = OUTPUT 



DESCRIPTION 
FILE TYPE TO BE TERMINATED. 

(DAYFILE, ACCOUNT, ERRLOG, MAINLOG) 
FAMILY FOR NEW DEVICE NUMBER THAT NEW 

DAYFILE IS TO RESIDE ON (1-7 CHARACTERS) 
DEVICE NUMBER OF NEW DEVICE (1-77B). 

FM AND DN DENOTE RESIDENT DEVICE 

DAYFILE IS INACTIVE. 



ACTIVE OR INACTIVE FILE 
(A OR I). 



TO BE TERMINATED 



NAME OF PERMANENT FILE. OVERRIDES 

AUTOMATIC NAMING (1-5 CHARACTERS). 

FILE TO RECEIVE OUTPUT (1-7 CHARACTERS). 



Figure 2-7. DFTERM Display 



:::::: PERMANENT DAYFILE CATALOG " :::J 
NO. TYPE FM/PN DN PFNAME DATE TIME LENGTH 



^k 



1. DAYFILE 

2. ACCOUNT 

3. ERRLOG 

4. MAINLOG 



SYST72 
SYST72 
SYST72 
SYST72 



01 
01 
01 
01 



DFA0331 
ACA0331 
ERA0331 
MLA0331 



80/03/31 
80/03/31 
80/03/31 
80/03/31 



13.35.33 
13.35.42 
13.35.49 
13.35.52 



1171 

402 

55 

1032 



Figure 2-8. DFTERM Dayfile List 
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If there are more files than can be displayed on one screen (page), a message appears at the bottom of 
the screen indicating that more files exist. When the LIST command is entered, a complete list of 
permanent dayfiles is written to the output file specified by the DFTERM L option; thus, a complete 
printer listing is provided when the DFTERM utility is terminated. If it is necessary to obtain the output 
listing immediately, the following command should be entered. 

K.OUT. 

When this command is processed, the initial right-screen K display (list of the queue file utility 
commands) is automatically returned. However, if the OUT command is not entered, the original 
right-screen K display can be returned by entering the CLEAR command. 

After DFTERM processing is completed, an output file indicating the results of this processing is 
generated if the LIST command has been entered at any time during DFTERM operations. (Refer to 
figure 2-8, which shows essentially the same format.) If the LIST command was not entered, no output 
file is generated. 



DFLIST 

DFLIST generates a printer listing of all permanent files created by the DFTERM utility. 

DFLIST can be initiated only from the system console directly through the following control statement. 

X. DFLIST. 

The output generated by DFLIST is the same as that produced by the LIST command available under the 
DFTERM utility (refer to figure 2-8). 



QIIST 

QLIST lists inactive I/O queue files, which may include all inactive queue files in the system or a 
selected subset based on options specified when the utility is called. 

The QLIST utility is not restricted to use from the system console. However, from the system console, 
QLIST must be called directly with the following control statement. No K-display interaction is 
available. 

X.QLIST(opt 1 =valx,opt2=val2,...,opt n =val n ) 

The applicable options associated with QLIST are the same, except for the OP option, as those used with 
the QREC utility. The OP option is not valid with QLIST. 

If all current inactive I/O queue files are to be listed, no options need be specified. In this case, the 
format of the QLIST call is as follows: 

X.QLIST. 

The output generated by QLIST is the same as that produced by the LIST command available under the 
QREC utility (refer to figure 2-4). 
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QDUMP 

QDUMP dumps selected I/O queue files from a single device, a family of devices, or all devices on the 
system. These queue files can be dumped either to tape or to mass storage. When active queue files are 
dumped, the FNT is searched to obtain the proper file. When inactive queues are dumped, the IQFT is 
searched. QDUMP also provides a listing of all files dumped with information about each file processed. 

When QDUMP is selected at the system console, the initial QDUMP K display appears on the left screen. 
This display contains a list of all applicable options associated with QDUMP, their default values, and a 
short description of each (refer to figure 2-9). 



QUEUE FILE DUMP 



INACTIVE QUEUES RESIDE ON FOLLOWING FAMI L I ES ( "=BLANK NAME). 
SYST72 



OPTIONS 
MI = 72 
FM r 

DN = ALL 
FU = ALL 
UI = OB 

377777B 
DA = 78/04/10 

78/04/15 
FS = OB 

777777B 
JN = 



DESCRIPTION (ERRORED FILE DUMPING SET) 
MACHINE ID (1-2 CHARACTERS, ALL). 
FAMILY FOR DEVICES (1-7 CHARACTERS). 
DEVICE NUMBER (1-77B,ALL). 
FAMILY FOR USER INDEX (1-7 CHARACTERS). 
USER INDEX RANGE (0-377777B). 

DUMP DATE RANGE (YYMMDD). 

FILE SIZE RANGE IN PRUS/10B (0-777777B). 

JOBNAMES (4 OR 7 CHARACTERS). 
JOBNAME WILL BE CLEARED IF 
PREVIOUSLY ENTERED. 



(0-377777B). 

FOR OUTPUT FILES. 
OUTPUT (1-7 CHARACTERS). 
1-7 CHARACTERS). 
NT, MS). 
ER OF TAPE. 
FILES TO SKIP. 
I-INACTIVE,ALL). 
YPE AND FILE TYPE. 
CLEARED IF PREVIOUSLY 
OPTION SELECTED. 

FT-FILE TYPE 
SF-SPECIAL PH-PUNCH 
IN-INPUT PR-PRINT 



ID = 


OB 
77B 


ID OF FILES TO D 


TID = 


OB 


DESTINATION TID 


FC = 


ALL 


FORMS CODE. 


DS = 




DEVICE SELECTION 


L = 


OUTPUT 


FILE TO RECEIVE 


FN = 


QFILES 


DUMP FILE NAME ( 


ME = 


MT 


DUMP MEDIA (MT, 


VSN = 


QFILE 


VISUAL REEL NUMB 


NF = 


0D 


NUMBER OF MEDIA 


TP = 


ALL 


TYPE ( A-ACTIVE, 


(OT = f 


r T) 


DUMP BY ORIGIN T 
OPTION WILL BE 




S I P P 


SELECTED. :: = 




F N H R 


OT=ORIGIN TYPE 


BC 


" " :{ " 


BC-BATCH 


EI 


:: ;: :: :: 


EI-EXPORT 


SY 


5C :c ;c :i 


SY-SYSTEM 



Figure 2-9. Initial QDUMP Display 
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If the FM option is specified, indicating dumping of queue files from a specified family of devices, the 
initial QDUMP left-screen K display is replaced by the secondary QDUMP K display (figure 2-10). This 
display closely resembles the initial QDUMP display but restricts QDUMP processing to the family of 
devices specified. Each device in the specified family containing inactive queue files is indicated. In 
addition, any option entered for the QDUMP utility is reflected in this display. Options not entered 
remain at default values. 



:::: " QUEUE FILE DUMP «'«« 

INACTIVE QUEUES RESIDE ON FOLLOWING DEVICES IN FAMILY - SYST72 
01 02 03 

OPTIONS DESCRIPTION (ERRORED FILE DUMPING SET) 

MI = 72 MACHINE ID (1-2 CHARACTERS, ALL). 

FM = SYST72 FAMILY FOR DEVICES (1-7 CHARACTERS). 

DN = ALL DEVICE NUMBER (1-77B,ALL). 

FU = ALL FAMILY FOR USER INDEX (1-7 CHARACTERS). 

UI = OB USER INDEX RANGE (0-377777B). 

377777B 

DA = 78/04/10. DUMP DATE RANGE (YYMMDD). 

78/04/15. 

FS = 0B FILE SIZE RANGE IN PRUS/10B (0-777777B). 

777777B 

JN = JOBNAMES (4 OR 7 CHARACTERS). 

JOBNAME WILL BE CLEARED IF 
PREVIOUSLY ENTERED. 



ID = 0B ID OF FILES TO DUMP (0-77B). 

77B 

TID= 0B DESTINATION TID (0-377777B). 

FC = ALL FORMS CODE. 

DS = DEVICE SELECTION FOR OUTPUT FILES. 

L = OUTPUT FILE TO RECEIVE OUTPUT (1-7 CHARACTERS). 

FN = QFILES DUMP FILE NAME (1-7 CHARACTERS). 

ME = MT DUMP MEDIA (MT, NT, MS). 

VSN = QFILE VISUAL REEL NUMBER OF TAPE. 

NF = 0D NUMBER OF MEDIA FILES TO SKIP. 

TP = ALL TYPE ( A-ACTI VE , I - I NACTI VE, ALL) . 

(OT=FT) DUMP BY ORIGIN TYPE AND FILE TYPE. 

OPTION WILL BE CLEARED IF PREVIOUSLY 
S I P P SELECTED. « = OPTION SELECTED. 

F N H R OT^ORIGIN TYPE FT=FILE TYPE 

BC - - « - BC-BATCH SF-SPECIAL PH-PUNCH 
EI " " " " EI-EXPORT IN-INPUT PR-PRINT 
SY - - - « SY-SYSTEM 



Figure 2-10. Secondary QDUMP Display 
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After QDUMP processing has been completed and K-display interaction has been terminated by 

K.STOP. 
an output file is generated, indicating all files dumped. Figure 2-11 contains an example of this output. 









IJ DUMPED 


QUI 


EUE 


FILE DISPOSITION 


5C :: » 




















LENGTH 




0. 


FILENAME 


MID 


FAMILY 


DN 


FT 


OT 


DATE (PRUS/10) 


DISPOSITION 


1 . 


WRITADB 


72 


SYS172 


1 


PR 


SY 


78/04/15. 




1 


ACTIVE 


2. 


WRITADF 


72 


SYS172 


1 


PR 


SY 


78/04/15. 




1 


ACTIVE 


3. 


LPTOACU 


72 


SYS172 


1 


PR 


SY 


78/04/15. 




30 


ACTIVE 


4. 


WRITADC 


72 


SYS172 


1 


PR 


SY 


78/04/15. 




1 


ACTIVE 


5. 


LPTOACZ 


72 


SYS172 


1 


PR 


SY 


78/04/15. 




30 


ACTIVE 


6. 


WRITADE 


72 


5YS172 


2 


PR 


SY 


78/04/15. 




1 


ACTIVE 


7. 


LPTOACW 


72 


SYS172 


2 


PR 


SY 


78/04/15. 




30 


ACTIVE 


8. 


WRITAOG 


72 


SYS172 


2 


PR 


SY 


78/04/15. 




1 


ACTIVE 



Figure 2-11. QDUMP Output File 



QDUMP does not purge files upon completion. If purging is desired, the following sequence of control 
statements is recommended. 



QREC(OP=DI) 
QDUMP(TP=I) 
QREC(OP=PI) 



To dequeue the files. 

To dump the inactive files. 

To purge the files. 



QLOAD 

QLOAD processes the dump files generated by QDUMP or other utilities using the same format. QLOAD 
can selectively load the I/O queues on these dump files. It creates the file on the specified device and 
writes the system sector. QLOAD can also list the contents of a dump file without loading any files. 

When QLOAD is selected at the system console, the QLOAD K display appears on the left screen. This 
display contains a list of all applicable options associated with QLOAD, their default values, and a short 
description of each (refer to figure 2-12). 

After QLOAD processing has been completed and K-display interaction has been terminated by 
K.STOP. 

an output file is generated, indicating all queue files which were contained on the dump file, whether 
they were loaded or not. Figure 2-13 contains an example of this output. 
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OPTIONS 


MI = 


72 


DF = 


ALL 


DD = 


ALL 


FU = 


ALL 


UI = 


OB 




377777B 


DA = 


78/Cf/10 




78/04/15 


FS = 


OB 




777777B 



::j:: QUEUE FILE LOAD " ::;; 

DESCRIPTION (ERRORED FILE LOADING NOT SET) 

MACHINE ID (1-2 CHARACTERS, ALL). 
DESTINATION FAMILY (1-7 CHARACTERS). 
DESTINATION DEVICE (1-77B). 
FAMILY FOR USER INDEX (1-7 CHARACTERS). 
USER INDEX RANGE (0-377777B). 

LOAD DATE RANGE (YYMMDD). 

FILE SIZE RANGE IN PRUS/10B (0-777777B). 

JN = JOBNAME (4 OR 7 CHARACTERS). 

JOBNAME WILL BE CLEARED IF PREVIOUSLY 
ENTERED. 



ID = OB ID OF FILES TO LOAD (0-77B). 

77B 

TID= OB DESTINATION TID (0-377777B). 

FC = ALL FORMS CODE. 

DS = DEVICE SELECTION FOR OUTPUT FILES 

I — rtllTDIIT C T I CT m nrrcil/r AiiTniiT r -\ 

i- — v/vjiiui lil_t_ \\j i\n,tl»C UUITUI \. 1 

FN = QFILES LOAD FILE NAME (1-7 CHARACTERS). 

ME = MT LOAD MEDIA (MT, NT, MS). 

VSN= QFILE VISUAL REEL NUMBER OF TAPE. 

NF = 0D NUMBER OF MEDIA FILES TO SKIP. 

SC = 0D NUMBER OF QUEUED FILES TO SKIP. 

OP = A LOAD OPTION (1 CHARACTER). 

A-LOAD/ ACTIVATE, I -LOAD/ I NACT I VATE 

(OT=FT) LOAD BY ORIGIN TYPE AND FILE TYPE. 

OPTION WILL BE CLEARED IF PREVIOUSLY 

S I P P SELECTED. « = OPTION SELECTED. 

F N H R OT=ORIGIN TYPE FT=FILE TYPE 

BC * ;: - « BC-BATCH SF-SPECIAL PH-PUNCH 

EI - - - * EI -EXPORT IN- INPUT PR-PRINT 

SY - « » * SY-SYSTEM 



Figure 2-12. QLOAD Display 
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LENGTH 




NO. 


FILENAME 


MI 


FAMILY 


DN 


FT 


OT 


DATE 


(PRUS/10) 


DISPOSITION 


1. 


WRITADB 


72 


SYS172 


1 


PR 


SY 


78/04/15. 


1 


ACTIVE 


2. 


WRITADF 


72 


SYS172 


1 


PR 


SY 


78/04/15. 


1 


ACTIVE 


3. 


LPTOACU 


72 


SYS172 


1 


PR 


SY 


78/04/15. 


30 


ACTIVE 


4. 


WRITADC 


72 


SY5172 


1 


PR 


SY 


78/04/15. 


1 


ACTIVE 


5. 


LPTOACZ 


72 


SYS172 


1 


PR 


SY 


78/04/15. 


30 


ACTIVE 


6. 


WRITADE 


72 


SYS172 


1 


PR 


SY 


78/04/15. 


1 


ACTIVE 


7. 


LPTOACW 


72 


SYS172 


1 


PR 


SY 


78/04/15. 


30 


ACTIVE 


8. 


WRITADG 


72 


SYS172 


1 


PR 


SY 


78/04/15. 


1 


ACTIVE 


9. 


LPTOACX 


72 


SYS172 


1 


PR 


SY 


78/04/15. 


30 


ACTIVE 


10. 


LPTOADA 


72 


5YS172 


1 


PR 


SY 


78/04/15. 


30 


ACTIVE 


11. 


LPTOACV 


72 


SYS172 


1 


PR 


SY 


78/04/15. 


30 


ACTIVE 


12. 


WRITADD 


72 


5YS172 


1 


PR 


SY 


78/04/15. 


1 


ACTIVE 


13. 


LPTOACY 


72 


SYS172 


1 


PR 


SY 


78/04/15. 


30 


ACTIVE 


14. 


WRITACK 


72 


SYS172 


1 


PR 


SY 


78/04/15. 


1 


ACTIVE 


15. 


LPTOACD 


72 


SYS172 


1 


PR 


SY 


78/04/15. 


30 


ACTIVE 



Figure 2-13. QLOAD Output File 



Example: 

The analyst can use the QDUMP and QLOAD utilities to dump queue files from one machine and load 
them onto another. The following control statements dump all punch files from machine AA. The QREC 
utility is used to dequeue the files and then purge them, because QDUMP does not purge files. 

QREC(NK,I=DIRCTVS,OP=DI) 

REWIND,DIRCTVS. 

QDUMP(NK,ME=MT,VSN=QUEUE,I=DIRCTVS,TP=I) 

REWIND,DIRCTVS. 

QREC(NK,OP=PI,I=DIRCTVS) 

File DIRCTVS is the input directive file which contains the following directives. 

BC=NONE, BC=PH. 
EI=NONE, EI=PH. 
SY=NONE, SY=PH. 

The following control statement loads the files dumped by the previous QDUMP onto another machine. 

QLOAD(NK,ME=MT,VSN=QUEUE,MI=AA,OP=A,DF=ALL) 



QMOVE 

QMOVE moves I/O queues from one mass storage device to another. It also produces a listing of all files 
moved with information about each file processed. 

When QMOVE is selected at the system console, the initial QMOVE K display appears on the left screen. 
This display contains a list of all applicable options associated with QMOVE, their default values, and a 
short description of each (refer to figure 2-14). 
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""- QUEUE FILE MOVE " ;c5J 

INACTIVE QUEUES RESIDE ON FOLLOWING F AMI L I ES( :: = 8LANK NAME). 
SYST72 



OPTIONS 



MI = 

FM = 
DN = 
DF = 
DD = 
FU = 
UI = 

DA = 

FS = 
JN = 



ID = 

TID = 

FC = 
DS = 
L = 
TP = 
OP = 



72 

ALL 

ALL 



ALL 

OB 

377777B 

78/03/26. 

7 8/03/31. 

OB 

777777B 



OB 
77B 
OB 
ALL 

OUTPUT 

ALL 

A 



COT=FT) 



S I P P 
F N H R 



BC 
EI 
SY 



DESCRIPTION (ERRORED FILE MOVING NOT SET) 
MACHINE ID (1-2 CHARACTERS, ALL). 
FAMILY FOR DEVICES (1-7 CHARACTERS). 
DEVICE NUMBER (1-77B, ALL). 
DESTINATION FAMILY (1-7 CHARACTERS). 
DESTINATION DEVICE (1-77B). 
FAMILY FOR USER INDEX (1-7 CHARACTERS). 
USER INDEX RANGE (0-377777B). 

DATE RANGE (YYMMDD). 

FILE SIZE RANGE IN PRUS/108 (0-777777B). 

JOBNAME (4 OR 7 CHARACTERS). 
JOBNAME WILL BE CLEARED IF 
PREVIOUSLY ENTERED. 



ID OF FILE TO MOVE (0-//BJ. 

DESTINATION TID (0-377777B). 

FORMS CODE. 

DEVICE SELECTION FOR OUTPUT FILES. 

FILE TO RECEIVE OUTPUT (1-7 CHARACTERS). 

TYPE (A-ACTIVE, I - I NACT I VE , ALL) . 

OPTION (A-LEAVE ACT I VE, I -LEAVE INACTIVE) 

MOVE BY ORIGIN TYPE AND FILE TYPE. 



OPTION WILL ! 
SELECTED. - 
OT=ORIGIN TYPE 
BC-BATCH 
EI-EXPORT 
SY-SYSTEM 



CLEARED IF PREVIOUSLY 

OPTION SELECTED. 

FT=FILE TYPE 
SF-SPECIAL PH-PUNCH 
IN-INPUT PR-PRINT 



Figure 2-14. Initial QMOVE Display 



If the FM option is specified, indicating the loading of queue files to a specified family of devices, the 
initial QMOVE left-screen K display is replaced by the secondary QMOVE K display (figure 2-15). This 
display closely resembles the initial QMOVE display but restricts QMOVE processing to the family of 
devices specified. Each device in the specified family containing inactive queue files is indicated. In 
addition, any option entered for the QMOVE utility is reflected in this display. Options not entered 
remain at default values. 
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s: «" QUEUE FILE MOVE »-" 

INACTIVE QUEUES RESIDE ON FOLLOWING DEVICES IN FAMILY - SYST72 
01 02 03 

DESCRIPTION (ERRORED FILE MOVING NOT SET) 
MACHINE ID (1-2 CHARACTERS, ALL). 
FAMILY FOR DEVICES (1-7 CHARACTERS). 
DEVICE NUMBER (1-77B, ALL). 
DESTINATION FAMILY (1-7 CHARACTERS). 
DESTINATION DEVICE (1-77B). 
FAMILY FOR USER INDEX (1-7 CHARACTERS). 
USER INDEX RANGE (0-377777B). 

DATE RANGE (YYMMDD). 

FILE SIZE RANGE IN PRUS/10B (0-777777B). 

JOBNAME (4 OR 7 CHARACTERS). 
JOBNAME WILL BE CLEARED IF 
PREVIOUSLY ENTERED. 



OPTIONS 


MI = 


72 


FM = 


SYST72 


DN = 


ALL 


DF = 




DD = 




FU = 


ALL 


UI = 


OB 




377777B 


DA = 


78/04/10 




78/04/15 


FS = 


0B 




777777B 



JN - 



ID = 

TID= 

FC = 
DS = 
L = 
TP = 
OP = 



0B 
77B 
0B 
ALL 

OUTPUT 

ALL 
A 



(OT=FT) 



S I P P 
F N H R 



BC 
EI 
SY 



ID OF FILE TO MOVE (0-77B). 

DESTINATION TID (0-377777B). 

FORMS CODE. 

DEVICE SELECTION FOR OUTPUT FILES. 

FILE TO RECEIVE OUTPUT (1-7 CHARACTERS). 

TYPE (A-ACTIVE, I - I NACT I VE, ALL) . 

OPTION (A-LEAVE ACT I VE, I -LEAVE INACTIVE) 

MOVE BY ORIGIN TYPE AND FILE TYPE. 



OPTION WILL ! 

SELECTED. - 
OT=ORIGIN TYPE 
BC-BATCH 
EI-EXPORT 
SY-SYSTEM 



IE CLEARED IF PREVIOUSLY 
= OPTION SELECTED. 

FT=FILE TYPE 
SF-SPECIAL PH-PUNCH 
IN-INPUT PR-PRINT 



Figure 2-15. Secondary QMOVE Display 

After QMOVE processing has been completed and K display interaction has been terminated by 

K.STOP. 
an output file is generated, indicating all files moved. Figure 2-16 contains an example of this output. 
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""- MOVED QUEUE FILE DISPOSITION "-- 
INACTIVE FILES MOVED TO FAMILY SYST72 DEVICE 1 AND LEFT ACTIVE 



NO. FILENAME MID FAMILY DN FT OT 



1. LPTOACD 

2. LPTOACF 

3. WRITACK 

4. LPTOACB 



72 SYS172 

72 SYS172 

72 SYS172 

72 SYS172 



LENGTH 
DATE (PRUS/10) ERRORS 



1 PR SY 78/0^/15 

1 PR SY 78/04/15 

1 PR SY 78/04/15 

2 PR SY 78/04/15 



30 

30 

1 

30 



Figure 2-16. QMOVE Output File 



Example 1: 

If there are inactive queue files residing on a removable device, the analyst can activate these files but 
must first move them to a nonremovable device. This example shows how to use the QMOVE utility to 
move queue files from the removable device with family name SYSTEM and device number 45 to the 
nonremovable device with familv name FAM1 and device number 5. The following entries are made from 
DSD. 



X.QFSP 

K,n. 

K.QMOVE. 

K.FM=SYSTEM,DN=45. 

K.DF=FAM1,DN=5. 

K.DD=3. 

K.OP=A. 

K.GO,STOP. 



(n=control point number of QFSP) 



(the moved files are active) 



Example 2: 

This example exhibits the relationships among the ID, TID, and FC parameter options. (Refer to the 
descriptions of these options for the types of files affected by them.) The following control statement 
moves all local batch and system origin output files with ID=6 and all remote batch origin output files to 
device 3 in family SYS. The SY, BC, and EI options explicitly disable input file processing. 

QMOVE(NK,DF=SYS,DD=3,ID=6,SY=IN,BC=IN,EI=IN) 

The following control statement performs the same function as the previous statement does except that 
no remote batch origin files are moved. 

QMOVE(NK,DF=SYS,DD=3,ID=6,SY=IN,BC=IN,EI=NONE) 
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LDLIST 

LDLIST generates a printer listing of queue files present on a QDUMP dump tape. 

The LDLIST utility is not restricted to use from the system console. However, from the system console, 
LDLIST must be called directly with the following control statement. No K-display interaction is 
available. 

X.LDLIST(opt 1 =vali,opt2=val2,...,opt n =-val n ) 

where optj=vali are parameter options available for LDLIST. 

The output generated by LDLIST is the same as that produced by QLOAD (refer to figure 2-13). 

QALTER 

QALTER displays, lists, and/or alters routing and other information about active queued output files. 
The utility selects files for processing according to a variety of user specified criteria. QALTER purges 
selected files from the system when the user specifies OP=PR. 

The user may alter the following information associated with the selected files. 

Origin type. 

File identifier (local batch origin files). 

Destination family (remote batch origin files). 

Destination user number (remote batch origin files). 

Forms code. 

Queue priority. 

Repeat count. 

When QALTER is selected at the system console, the QALTER K display appears on the left screen. This 
display contains a list of all applicable parameters associated with QALTER, their default values, and a 
short description of each (figure 2-17). The following procedure should be performed to alter active 
queued output files. 

1. Enter the selection criteria specifying which files are to be altered (parameters FM, DN, JN, 
JC, DS, FC, ID, DF, UN, BC, and EI). 

2. Ensure that the desired files are selected by inspecting the list of files produced by the 
K-display commands LIST or OUT (figures 2-18, 2-19, and 2-20). If the file produced by OUT is 
to be other than OUTPUT or contain a detailed listing of the selected files, specify such with 
the L and/or LO parameters before entering K.OUT. 

3. Enter the new information to be associated with the selected files (parameters OP, NDF, NUN, 
NID, NFC, NPR, and NRC). QALTER changes only information specified via parameter entry. 

4. Enter K.GO. QALTER makes the requested changes, issues the message *QALTER 
COMPLETE.*, and resets the K-display parameters to their default values. 

5. Repeat steps 1 through 4 to alter additional files, or enter K.STOP. to terminate QALTER 
activity. 
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OPTIONS 

FM = ALL 
DN = ALL 

JN = 



JC 


= 


ID 


= OB 




77B 


DF 


- 


UN 


= 


DS 


= 


FC 


= 


L 


= OUTPUT 


LO 


= S 



(OT=FT) 







I P P 






N H R 


BC 




a 5J a 


EI 




:: J: :i 


OP = 


NC 




NDF = 






NUN = 






NID = 






NFC = 






NPR = 






NRC = 







;::c " LIST ACTIVE QUEUED FILES """ 

DESCRIPTION 
FAMILY FOR DEVICES (1-7 CHARACTERS) 
DEVICE NUMBER (1-77B,ALL). 
JOBNAME (4 OR 7 CHARACTERS). 

JOBNAME WILL BE CLEARED IF 

PREVIOUSLY ENTERED. 



JOBCARD NAME (1-7 CHARACTERS) 
ID OF FILE TO LIST (0-77B). 



DESTINATION FAMILY (1-7 CHARCTERS). 
DESTINATION USER (1-7 CHARACTERS). 
DEVICE SELECTION FOR OUTPUT FILES. 
FORMS CODE. 

FILE TO RECEIVE OUTPUT (1-7 CHARACTERS) 
LIST OPTION (S=SHORT,F=FULL). 



SELECT BY ORIGIN TYPE AND FILE TYPE. 

OPTION WILL BE CLEARED IF PREVIOUSLY 

SELECTED. » = OPTION SELECTED. 

OT=ORIGIN TYPE FT=FILE TYPE 

BC-BATCH IN-INPUT PH-PUNCH 

EI-EXPORT PR-PRINT 

OPTION (BC,EI,NC,PR). 

NEW DESTINATION FAMILY (1-7 CHARACTERS). 

NEW DESTINATION USER (1-7 CHARACTERS). 

NEW FILE IDENTIFIER (0-67B). 

NEW FORMS CODE (AA-99,""). 

NEW PRIORITY FOR OUTPUT (0-7760B). 

NEW REPEAT COUNT (0-37B). 



Figure 2-17. QALTER/FNTLIST Left Screen K Display 



:::S!S ACTIVE QUEUE FILE LIST -<— 
ORD. FILENAMO. FT FAMILY USERNUM TID/ID FC DC EXTCH REP 



20. QRECAHUS. PR 

hi. DISOAHXE. PR SYS172 RUSS 




27 



LP LP 

LP LP 



Figure 2-18. QALTER/FNTLIST LIST Command Display 
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- : ACTIVE 


QUEUE 


LIST " ;::i 






FILENAME 


= 


DISOAHX 




ORDINAL 




47 


ORIGIN 


= 


REMOTE 




QUEUE 


= 


PRINT 


DESTINATION 






CREATION 






FAMILY 


= 


SYS172 




FAMILY 


— 


SYS172 


USER 


= 


RUSS 




USER 


r 


RUSS 


TID/ID 


= 


27 




USR INDX 


= 


27 


FORMS 


— 






JOB CARD 


- 




DEVICE 


= 


LP 




DATE 


= 


78/03/31 


EXT.CHR. 


= 


LP 




LENGTH 


- 


1 


INT.CHR. 


= 


DIS 




REPEAT 


= 





RESIDENCE 








INTERRUPT 


- 


NO 


FAMILY 


= 


SYST72 




PRIORITY 


— 


401 


DEVICE 


— 


3 








A 



Figure 2-19. Q ALTER/ FNTLIST LIST=fnt Command Display 



Example: 



The analyst can use the QALTER utility to divert output files from the local printers to a remote 
terminal. The following control statement alters the routing of all batch and system origin output files 
with forms code of AD. These files are routed to a remote terminal with family name FAM1 and user 
number USRNUM. The BC and EI options explicitly disable input file selection. 

QALTER(NK,BC=IN,EI=IN,FC=AD,OP=EI,NDF=FAMl,NUN=USERNUM) 

The FNTLIST utility can be used in conjunction with QALTER to ensure that the files were properly 
altered. The following control statement generates a list of all active queued files belonging to the 
remote terminal with family name FAM1 and user number USRNUM. 

FNTLIST(NK,LO=F,DF=FAMl,UN=USRNUM,BC=NONE) 



FNTLIST 

FNTLIST displays and/or lists routing and other information about active queued output files. Its 
operation is similar to that of QALTER, except file alteration or purging is not allowed. When FNTLIST 
is selected at the system console, the FNTLIST K display appears on the left screen. This display 
contains a list of all applicable options associated with FNTLIST, their default values, and a short 
description of each (refer to figure 2-17). The output generated by FNTLIST LIST and OUT K display 
commands (both printed and right-screen K display) is similar or identical to that produced by QALTER. 
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en 



co 
oo 



QALTER - ALTER/PURGE ACTIVE QUEUED FILES. 



78/04/20. 10.37.33. 



PAGE 







OPTION 


= NC 


NEW F 


r ORMS CODE 


= --N/A-- 


NEW 1 


PRIORITY 


= 5103 


NEW REPEAT COUNT 


= — N/A — 


CURRENT 




" :c " :!!: """ : 


:::: 


i! """"""" 


:c;::c:c;c:c:c:c 


1. FILENAME 


= 


QISOAAH 


FAMILY 


ORIGIN 


= 


REMOTE 


USER 


QUEUE 


= 


PRINT 


TID/ID 


ORDINAL 


= 


24 




2. FILENAME 


= 


QISOAAH 


FAMILY 


ORIGIN 


= 


BATCH 


USER 


QUEUE 


= 


PRINT 


TID/ID 


ORDINAL 


= 


31 




3. FILENAME 


= 


QISOAAH 


FAMILY 


ORIGIN 


= 


REMOTE 


USER 


QUEUE 


= 


PUNCH 


TID/ID 


ORDINAL 


= 


32 




4. FILENAME 


= 


DISOAAM 


FAMILY 


ORIGIN 


= 


SYSTEM 


USER 


QUEUE 


= 


PRINT 


TID/ID 


ORDINAL 


= 


47 





NEW DESTINATION FAMILY NAME = --N/A-- 

NEW DESTINATION USER NUMBER = --N/A — 

NEW FILE IDENTIFIER = — N/A — 



DESTINATION 



;:c3c;c;c:c:c:c:c:c:c :c ::::>: 



= SYS172 FORMS = 

= RUSS DEVICE = LP 

= 27 EXT.CHR. = LP 

INT.CHR. = DIS 

= FORMS = AS 

= DEVICE = LT 

= 4 EXT.CHR. = LP 

INT.CHR. = DIS 

= SYS172 FORMS = 

= RUSS DEVICE = PH 

= 27 EXT.CHR. = B6 

INT.CHR. = DIS 

= FORMS = 

= DEVICE = LP 

= EXT.CHR. = LP 

INT.CHR. = DIS 



CREATION 
ic sc sc sc sc :c :: sc :c ;c :c sc ic sc sc sc sc sc sc sc sc :: :c ;c se sc :: sc k sc sc :c sc :: sc sc : 



RESIDENCE 
sc a :c :: :c sc x :: :: :: sc :c :t :c ic :c :: :c 



FAMILY 


= 


SYS172 


JOBCARD = 


QIS 


FAMILY 


= 


SYST72 


USER 


= 


RUSS 


DATE = 


78/04/20 


DEVICE 


= 


2 


USR INDX 


= 


27 


LENGTH = 


33 


PRIORITY 


= 


260 


REPEAT 


= 





INTERRUPT= 


NO 








FAMILY 


= 


SYS172 


JOBCARD = 


QIS 


FAMILY 


— 


SYST72 


USER 


= 


RUSS 


DATE = 


78/04/20 


DEVICE 


= 


2 


USR INDX 


= 


27 


LENGTH = 


5 


PRIORITY 


= 


261 


REPEAT 


= 





INTERRUPT= 


NO 








FAMILY 


= 


SYS172 


JOBCARD = 


QIS 


FAMILY 


— 


SYST72 


USER 


= 


RUSS 


DATE 


78/04/20 


DEVICE 


a 


3 


USR INDX 


= 


27 


LENGTH = 


26 


PRIORITY 


= 


261 


REPEAT 


= 





INTERRUPT= 


NO 








FAMILY 


= 


SYS172 


JOBCARD = 




FAMILY 


= 


SYST72 


USER 


= 




DATE = 


78/04/20 


DEVICE 


= 


3 


USR INDX 


= 


122 


LENGTH = 


3 


PRIORITY 


= 


461 


REPEAT 


= 





INTERRUPT= 


NO 









Figure 2-20. QALTER Printer Listing 



Example 1: 

The analyst can use the FNTLIST utility to determine what actions are necessary to get queued output 
files processed by RBF, BATCHIO, or EI200. The following FNTLIST entry generates a detailed list of 
queue files, from which forms code, id, device selection, and other destination routing information can be 
determined. This information indicates what action must be taken to have the files processed. 

X.FNTLIST(NK,LO=F) 

Example 2: 

The analyst can use the FNTLIST utility to determine what queue files are routed to a particular device. 
The following FNTLIST entry generates a list of all print files with forms code of A A that are routed to a 
580-20 (LT) printer. The BC and EI options explicitly disable input file selection. 

X.FNTLIST(NK,DS=LT,FC=AA,BC=IN,EI=IN) 



DAYFILE DUMPING UTILITIES 

The dayfile dumping utilities (AFD, DFD, ELD, MAINLOG) write all or selected parts of the account, 
system, error log, or binary maintenance log dayfiles to a file. AFD, DFD, and ELD produce a listing 
(output) file; MAINLOG produces its output in a binary format. A job using any of these utilities must be 
a system origin job, or the user must have system origin privileges and DEBUG must be set at the 
console. The following format is used to call the dayfile dumping utilities. 

utility(listfil,string,op,pd,pl,infile,binfile) 

or 

utility(L=listfil,FR=string,OP=op,PD=pd,PL=pl,I=infile,B=binfile) 



utility 



L=listfil 



FR=string 



Utility called to perform the dayfile dump. 

AFD Dump account dayfile. 

DFD Dump system dayfile. 

ELD Dump error log dayfile. 

MAINLOG Dump binary maintenance log dayfile. 

Output file containing the dayfile dump produced by AFD, DFD, or ELD. The 
utility also places diagnostic messages in this file when various error 
conditions occur. These messages begin with NOTICE*** to distinguish them 
from the lines of the dayfile being processed, and are described in appendix B. 

Omitting this option sets listfil to OUTPUT. The utility paginates listfil if it is 
OUTPUT or if print density and page length are specified. L=listfil is not used 
with MAINLOG. 

Search string for selective dayfile dumping. The utility searches the dayfile 
for this string in the starting position of the field specified by the OP=op 
parameter. 
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OP=op Dump option. If neither FR=string nor the OP dump option is specified, 

default is OP=F. If FR is specified but OP is not, default is OP=M. 

op Description 

F Full dayfile dump is taken. 

I Incremental dump is taken. The dayfile is dumped starting from the 
point of the last dayfile dump. AFD does not process the I option 
when executed within a job with system origin privileges that is not 
system origin. 

J The job name field in the dayfile is searched for the string specified 
by FR=string. The dump begins from that point. 

M The message field in the dayfile is searched for the string specified 
by FR=string. The dump begins from that point. OP=M cannot be 
used with MAINLOG. 

P Incremental dump by user number is taken. The dayfile is dumped 
starting from the point of the last dayfile dump by this user. 

T The time field in the dayfile is searched for the string specified by 

UB-efninff Tho Aimn Korrino fns\m +J-><->+ r^^I.^+ 
J. iv-oumg^ 111c VJUllip isGgJLUO 11U11I I. IKXt pVllll. 

PD=pd Print density in pd lines per inch (3, 4, 6, or 8). Default is PD=6. PD cannot be 

used with MAINLOG. 

PL=pl Page length in pi lines per page. Default is based on the following print 

densities. PL cannot be used with MAINLOG. 



pd 


Default pi 


3 


30 


4 


40 


6 


60 


8 


80 



I=infile An attached, terminated dayfile to be used for input. If omitted, the utility 

uses the active dayfile for input. 

B=binfile File on which MAINLOG writes the binary maintenance log. MAINLOG writes 

binfile with W-type records having C-type blocking (refer to the CYBER 
Record Manager Basic Access Methods Reference Manual for further 
information on record types and record blocking). MAINLOG assumes B=BML 
if this option is omitted. 
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MASS STORAGE SUBSYSTEM 



The Mass Storage Facility (MSF) hardware product is a large capacity on-line mass storage device, which 
is a cost effective extension to the disk file storage system and an alternative to conventional magnetic 
tape storage. Storing files on MSF retains the security, data integrity, and on-line access capabilities 
provided by disk and reduces the operational and data integrity problems caused by storing, retrieving, 
and mounting tape volumes. Capabilities are provided for use of both MSF and magnetic tapes to protect 
files from hardware and system failures. 

MSF is comprised of the following components. 

Cartridge A plastic housing that encloses 100 inches (2500 millimetres) of magnetic tape on 

which data is stored under program control. 

Coupler The interface between the CDC CYBER peripheral processor (PP) and the mass 

storage adapter (MSA), which includes a buffer that contains data going to or 
coming from the mass storage transport (MST). 



MSA 



Cartridge storage unit, which includes storage cells (cubicles) for 2052 cartridges t 
and a selector that moves cartridges among the MST, the cubicles, and the I/O 
drawers of the CSU. Each CSU has two I/O drawers; the top one is the input 
drawer and the bottom one is the output drawer. Each drawer has eight vertically 
aligned drawer slots, numbered from (top slot) to 7 (bottom slot). There can be 
up to 13 CSUs in an MSS configuration. Each CSU in a configuration is associated 
with a letter from A through M, which is the CSU identifier. 

Mass storage adapter, which interfaces between the coupler and the MST or the 
CSU. 



MST 



Mass storage transport, which includes storage positions for five cartridges: one 
being read or written, two queued for reading or writing, and two queued for 
storage by the selector into the CSU. 



The Mass Storage Subsystem (MSS) is the product consisting of the MSF hardware, the CYBER coupler, 
the diagnostics, and the operational software. The basic function of MSS is to store data on MSF and 
move it to disk upon request for access by an authorized user. Control of file movement between disk 
and MSF is largely transparent to the applications programmer; however, there are operational changes 
and additions that are of importance to site operations personnel. These include modifications to 
operational procedures in the areas of permanent file backup, permanent file recovery, and disk space 
management. In addition, new MSS utilities are introduced. Detailed information about the call and 
operation of each MSS utility is contained in the following sections. 



Utility 
ASDEF 

ASLABEL 
ASMOVE 



Description 

Creates the system files (CSU maps and MSF catalogs) necessary for MSS 
processing. 

Manages the allocation of cubicles and assignment of cartridges in the CSU. 

Controls the destaging of files (creating MSF images) and the releasing of disk 
space. 



t2000 cartridges are available for file data storage and the rest are reserved for customer engineer 
and system use. 
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Utility Description 

ASVAL Controls the releasing of MSF space and analyzes the CSU maps, MSF catalogs, 

and PFC entries to identify and flag discrepancies within these three components. 

ASUSE Provides reports on the assignment and availability of cartridges and cubicles 

within a CSU. 

ASDEBUG Corrects error conditions detected by ASVAL and recovers data from MSF 

cartridges. 



DEFINITIONS 

The descriptions of the MSS utilities require some familiarity with the terms whose definitions follow. 

CARTRIDGE 

A cartridge is the MSS data storage component consisting of 16 streams, called allocation units (AUs). 
Streams that have data written on them (allocated streams) are chained together in the MSF catalog 
(definition following) to identify the sequence of streams that must be accessed in order to read a file on 
MSF. A head of chain (HOC) flag identifies the first AU in the chain, a link field identifies the next AU 
in the chain, and an end of chain (EOC) flag identifies the last AU in the chain. 

The cartridge label contains information that characterizes one of the three types of cartridges that can 
be used in an MSS environment. Cartridges having label types other than the following cannot be 
processed by MSS except by the ASLABEL utility, which can rewrite the cartridge label, or by the 
ASDEBUG utility, which can write the data on the cartridge to a permanent file. 

• A manufacturer's label contains the volume serial number (vsn) of the cartridge in a 
machine-readable format. A cartridge with a manufacturer's label can be added to a CSU and 
assigned to a subfamily or pool (refer to the ASLABEL utility). 

• A scratch label contains the vsn of the cartridge and additional system information indicating 
that the cartridge is available for assignment by the ASLABEL utility. A scratch label also 
contains the usage record of the cartridge. A cartridge with a scratch label is called a scratch 
cartridge. 

• A family label contains the vsn of the cartridge and additional system information indicating 
that the cartridge is assigned to a particular subfamily. It also indicates the CSU identifier and 
the X, Y coordinates of the cubicle where the cartridge resides when it is not in use. 

The addition, removal, and reassignment of cartridges are managed by the MSS utilities. The cartridge 
labels, and also the MSF catalogs and CSU maps (definitions following), contain information concerning 
the location and content of the cartridges. When a cartridge is labeled and assigned to a subfamily, a 
label is written on each stream of the cartridge, which contains the cartridge vsn, the CSU id, X, Y 
coordinates, family, and subfamily to which it was assigned, and the stream number of the particular 
stream. If such a cartridge is accessed for relabeling or for reading or writing an MSF file, the stream 
label verification procedure is used to verify this stream label information against the data in the MSF 
catalogs and CSU maps. If a discrepancy is detected, an error message is issued and corrective action 
must be taken to update the cartridge labels and/or system files as described in a later section. 
Whenever the cartridge location or content is changed, the cartridge label, MSF catalogs, and CSU maps 
are updated to reflect the current status of the cartridge. The descriptions of the MSS utilities contain 
further information on cartridge management. 
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CSU MAP 

A CSU map is a direct access permanent file that contains information indicating how cubicles in a CSU 
are assigned to a family and identifying the cartridges that reside in the CSU.t There is one CSU map 
for each CSU in the configuration. The permanent file name of the CSU map is CSMAPi, where i is the 
CSU identifier (a letter from A through M); its user index is 377760 8 ; and its family is the default family 
on the mainframe on which MSSEXEC executes (refer to the definition of MSSEXEC). 

A CSU map contains an entry for each possible X, Y coordinate pair that identifies a cubicle in the CSU, 
from X=0, Y=0 (bottom right) to X=57, Y=36 (upper left). There are no cubicles at the positions where 
X-30 or Y=18, but there are entries in the CSU map for such coordinate pairs and these entries indicate 
that no cubicle exists there. Thirty-one cubicles are reserved for customer engineer use; they have the 
foUowing X, Y coordinates: X=57, Y=36; X=0, Y=36; X=57, Y=0; X=26 through X=0, Y=0. Twenty-one 
cubicles are reserved for system use; they have the foUowing X, Y coordinates: X=48 through X=31, Y=0; 
X=29 through X=27, Y=0. In all, there are 2146 entries in a CSU map and they are ordered (assigned a 
map entry ordinal) according to the positions in the CSU of the corresponding cubicles. That is, the 
foUowing scheme is used to relate the X, Y coordinate pairs and the map entry ordinals. 

• Given the X and Y coordinates, the ordinal is 2146 - X - (Y*58). 

• Given the ordinal, Y is the whole number quotient of (2146 - ordinal)/58 and X is the remainder. 

• Ordinal does not represent a coordinate pair; it is used as a map header entry. 

Thus, in a CSU map the zero entry is the map header entry; the first entry describes the cubicle at X=57, 
Y=36; the second entry describes the cubicle at X=56, Y=36; and so forth. 

Each entry in a CSU map has the foUowing format: 



59 


58 


53 






42 41 


36 







code 


ord 




family 


jf 


'//////, 


w, 


% 


sub 


vsn 



code Number from 1 to 7 indicating how the cubicle is assigned. 

Code Description 

1 Reserved for customer engineer. 

2 Reserved for system use. 

3 Reserved for a different CSU map. 

4 Assigned to the cartridge scratch pool.t 



t The pool is an area of the CSU that stores scratch cartridges that are managed by the ASLABEL utility. 
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Code Description 

5 Assigned to a subfamily. 

6 Unassigned. 

7 No cubicle exists at these coordinates (X=30 or Y=18). 

ord Ordinal for this cubicle in the MSF catalog of the subfamily to which the 

cubicle is assigned. This ordinal is referred to as the FCT ordinal (refer to 
the definition of MSF catalog). This field is meaningful only if code = 5. 

family Seven-character name in display code of the family to which the cubicle is 

assigned. This field is meaningful only if code = 5. 

I Linkage error flag that is set by the ASVAL utility when a CSU map entry of 

a cubicle assigned to a family has no corresponding entry in the MSF catalog. 

sub Number from through 7 identifying the subfamily to which the cubicle is 

assigned. This field is meaningful only if code = 5. 

vsn Six-character volume serial number of the cartridge assigned to the cubicle. 

If no cartridge is assigned, this field contains spaces. 

The zero entry in the CSU map is the map header entry. In this entry the code field is 7, the leftmost 6 
bits of the second word contain the CSU identifier, and the remaining bits are unused. 

The CSU map is updated whenever the ASLABEL, ASVAL, or ASDEBUG utility causes a change in cubicle 
or cartridge assignment. It is recommended that the CSU map be backed up after every update to avoid 
problems such as the following: 

• Mismatches between CSU map and MSF catalog entries. 

• Lost CSU maps because of a disk failure or other problem. 

• Attempts to access cartridges that are no longer available. 

• Attempts to store cartridges in cubicles that are no longer empty. 

Thus, the analyst should make a copy of the CSU map on tape or another device or family to always 
retain the latest version of the CSU map. If a device containing CSU maps is reloaded, the latest version 
of the CSU maps should be recovered from the backup copy after the reload is completed. After 
recovering the CSU maps, the analyst should run the ASVAL utility to check that the entries in the CSU 
maps and MSF catalogs match. If there are inconsistencies, corrective action should be taken as 
described in Error Conditions and Corrective Action in a later section. 



MSF CATALOG 

An MSF catalog is a disk resident direct access permanent file that contains information describing 
which streams of each cartridge assigned to a particular subfamily are allocated to MSF files and which 
streams are available for allocation. There is one MSF catalog for each subfamily of a family that can 
have MSF resident files, and it resides on the master device for the subfamily. The permanent file name 
of the MSF catalog file is MSFCATi and its user index is 37776i8, where i is the subfamily identifier (a 
number from through 7). For example, file MSFCAT3 and user index 3777638 identify the MSF catalog 
for subfamily 3. 
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An MSF catalog is partitioned into subcatalogs, one subcatalog for each CSU used by the subfamily. The 
maximum number of subcatalogs in an MSF catalog is 13 (the maximum number of CSUs in a 
configuration). Each subcatalog consists of two parts: the file and cartridge table (FCT) and the 
available stream table (AST). The FCT has an entry for each cubicle assigned to the subfamily from the 
given CSU. The maximum number of FCT entries in a subcatalog is 2000 (the maximum number or user 
cartridges in a CSU). The AST contains information used by the allocation algorithm to select the 
cartridges on which a file will reside. 

The preamble of the MSF catalog contains a header and at most 13 subcatalog entries. The header 
identifies the family and subfamily of the MSF catalog and each subcatalog entry contains the length and 
location of its FCT and AST, the CSU identifier, unallocated stream count, and date of last ASVAL run 
that resulted in the releasing of MSF space assigned to the particular CSU or the setting of flags in 
entries for cubicles in the CSU. The format of the header is as follows: 



59 






17 


II 







family 


sub 


unused 


unused 



family Seven-character name in display code of the family for this MSF catalog, 

sub Number from to 7, identifying the subfamily for this MSF catalog. 

The format of the subcatalog entry is as follows: 

59 53 41 35 29 17 



id 


length 


FCT loc 


AST loc 


streams 


unused 


date time 



id CSU identifier for the subcatalog (a letter from A to M). 

length Number of FCT (and AST) entries in the subcatalog. 

FCT loc Location (beginning PRU number) of the FCT. 

AST loc Location (beginning PRU number) of the AST. 

streams Number of unallocated streams for this subcatalog. 

date time Date and time of the last releasing of orphan files on the CSU identified by id 

or the last time flags were set for cartridges or cubicles in the CSU 
(whichever is later). 

The header and subcatalog information is arranged in the following order: 

1. First word of the header. 

2. First word of each of the subcatalog entries. 

3. Second word of the header. 

4. Second word of each of the subcatalog entries. 
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Each cubicle from the given CSU assigned to the subfamily has an entry in the FCT of the subcatalog. 
This entry contains the X,Y coordinates of the assigned cubicle. If a cartridge has been assigned to the 
cubicle, the FCT entry also contains the vsn of the cartridge, usage information, status flags, and 
information about each of the 16 streams of the assigned cartridge. The format of each FCT entry is as 
follows: 



59 57 


53 


47 


41 


35 


33 


29 


27 




20 







bps 


flags ^ 


X 


y 


vsn 


unused 


link] 


reserved 


load 


unused 


Iink2 


reserved 


pass 


unused 


link 3 


reserved 


error 


*1 


x 2 


x 3 


unused 


*1 


V2 


y3 


unused 


reserved for site 


u 


pru 


flags 2 


chain 


u 




stream 


detail 




j 


reserved for CDC 



bps 
flagsi 



Number of blocks per stream on the cartridge assigned to this cubicle. 
One of the following flags. 



Bit 



53 



52 



51 



50 



49 



48 



Description 

Inhibit allocation flag, indicating that space from the 
cartridge assigned to this cubicle is not to be allocated to a 
file. This flag is set by a directive to the ASLABEL utility. 

Lost cartridge flag, indicating that the cartridge assigned to 
this cubicle was not there the last time MSSEXEC tried to 
pick it. This flag can be cleared by a directive to the 
ASLABEL utility. 

Excessive write parity error flag. Space from such a 
cartridge will not be allocated. This flag can be cleared by a 
directive to the ASLABEL utility. 

Reserved. 

Linkage error flag, indicating that the CSU map entry for this 
X,Y location is inconsistent with this FCT entry. 

Reserved. 
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x X coordinate of this cubicle. 

y Y coordinate of this cubicle. 

vsn Six-character volume serial number of the cartridge assigned to this cubicle. If no 

cartridge is assigned, this field contains spaces. 

link} Ordinal of the FCT entry for the cubicle containing the next cartridge on which 

the file on the cartridge assigned to this cubicle resides. If a file does reside on 
multiple cartridges, the entire file must be contained in one CSU. Also, since 
there are only three link fields, if a cartridge contains several files, only three can 
be contained on other cartridges. 

load Number of times the cartridge assigned to this cubicle has been loaded to a MST 

read/write station. 

pass Number of times the cartridge assigned to this cubicle has been passed across a 

read/write head. 

error Number of recovered read errors for the cartridge assigned to this cubicle. 

X} X coordinate of the cubicle in which the cartridge referred to by the linkj field 

resides. 

yi Y coordinate of the cubicle in which the cartridge referred to by the linkj field 

resides. 



u 


Unused. 


pru 


Number of PRUs on the stream. 


flags 2 


One of the following: 




Bit Description 




47 Start of fragment flag; set by the A 




46 Frozen chain flag, indicating a pr 



chain. Streams in this chain are not reused until a directive 
to the ASDEBUG utility clears the flag. 

45 Stream conflict flag, indicating an allocation conflict 

involving this stream. This flag is set by the ASVAL utility or 
by MSSEXEC. 

44 Reserved. 

43 Free/busy flag, indicating whether or not this stream is 

currently allocated to a file. 

42 Reserved. 

41-40 Off-cartridge link flag indicating that the next stream of the 

file is on another cartridge. The next cartridge is identified 
by one of the linkj fields. The value of the off-cartridge link 
flag (1, 2, or 3) specifies which linkj to use. The chain field 
specifies the stream number on the next cartridge. Only 
three of the 16 streams of a cartridge can have this flag 
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Bit Description 

set at any one time. This field is meaningful only if the chain 
control field indicates that this stream is the first or middle 
stream of the file. 

39-38 Unused. 

37-36 Chain control, indicating whether the stream is a first (1), 

last (2), only (3), or middle (0) stream of the file. This field is 
meaningful only if the stream is allocated to a file. 

35-34 Unused. 

chain Next stream number, if any, containing file data for the file. This field is 

meaningful only if the stream is allocated to a file. 

stream-^ detail PRU, flag, and chain control information about stream 1. The upper 30 bits of 
this word contains information about stream 0. The lower 30 bits are divided into 
the same fields, and contain information about stream 1. The next seven words 
are divided similarly: the upper 30 bits contain information about stream 2, 4, 6, 
8, 10, 12, or 14 and the lower 30 bits contain information about stream 3, 5, 7, 9, 
11, 13, or 15. 

The MSF catalog is updated whenever the ASLABEL, ASMOVE, ASVAL, or ASDEBUG utility causes a 
change in cartridge or cubicle assignment that affects the subfamily. Because the MSF catalog for a 
subfamily resides on its master device, it will be backed up by PFDUMP whenever the master device for 
the subfamily is dumped. Consequently, when PFLOAD reloads all files, the MSF catalogs are 
automatically recovered and all MSF-resident files as indicated in a recovered PFC will also have entries 
in the recovered MSF catalog. Thus, no special operational procedures are needed to back up an MSF 
catalog. It is possible, however, that the MSF catalog will be inconsistent with the CSU maps or 
cartridge labels. If such inconsistencies do exist, corrective action will have to be taken as described in 
Error Conditions and Corrective Action in a later section. 



MSF FILES 

In an MSS environment, permanent files can be categorized according to whether or not they reside on 
MSF. A disk file is a permanent file that resides on disk but not on MSF. An MSF file is a permanent file 
that resides on MSF and may or may not also reside on disk, depending on how the installation manages 
disk space (refer to Disk Space Management in a later section). Depending on backup requirements (BR 
parameters), both disk and MSF files can also have backup images on tape (refer to volume 1 of the NOS 
Reference Manual). 

When a user defines a direct access file, initially it is a disk file. A disk file becomes an MSF file when it 
is destaged to MSF; that is, an image of the file is created on MSF. Destaging files is accomplished 
through the ASMOVE utility, which is run periodically to manage disk space. When ASMOVE is run, files 
are destaged to MSF and/or their disk space released depending on certain file characteristics (refer to 
ASMOVE in a later section). Thus, after an ASMOVE run a file can reside on disk, on MSF, or on both. If 
the file does have an MSF image, the alternate storage address (asa) field in the PFC entry for the file 
indicates the location of the MSF copy. The obsolete (AFOBS) flag in the PFC entry indicates whether or 
not the MSF image is a current version of the file. 

When a user attaches an MSF file, it is staged to disk from MSF (that is, a disk image is created) if the 
current version of the file is not on disk. If the file is attached in write mode, the MSF image is marked 
obsolete; that is, the AFOBS flag in the PFC entry for the file is set. This is because the disk image is 
immediately updated when the user makes changes to the file, but the MSF image is not updated until the 
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ASMOVE utility is run again. Hence, the current version of the file resides on disk only. Setting the 
AFOBS flag ensures that the current version of the file will be copied to MSF and will replace the 
obsolete MSF file the next time ASMOVE is run. When a user attaches a file, however, it is always the 
current version of the file that he accesses; an obsolete file cannot be accessed. 

If the file is purged, its disk space, but not its MSF space, is immediately released. The ASVAL utility 
must be run to release MSF space allocated to purged files. Thus, because a purged file has no PFC entry 
linking to its MSF catalog entry, the MSF image that still exists before ASVAL is run is called an orphan 
file. However, a user can never access an orphan file. 

When a file is destaged to MSF, information is written on each stream to which the file data is written. 
This information includes the file's creation date and time and user index from the PFC entry, the 
identity of the first stream to which the file is written, the identity of the stream immediately preceding 
this one, and the number of disk PRUs of data recorded on previous streams (for all but the first stream 
of multistream files). 

When a file is staged back to disk, the file label verification procedure is used to verify this file label 
information against the stream label information (refer to the definition of cartridge) for each stream of 
the file. If a discrepancy is detected, an error message is issued, the file stage is aborted, an error flag 
is set in the PFC entry to indicate that the MSF file could not be accessed, and the stream conflict error 
flag is set in the MSF catalog entry for the particular cartridge(s) and stream(s). 

14 e o e v c f~ 

MSSEXEC is the main processing program that is responsible for controlling MSS activities. The MSS 
utilities issue requests to MSSEXEC to destage files from disk to MSF, purge unneeded MSF files, label or 
relabel cartridges, update CSU maps and MSF catalogs, and so forth. In a multimainframe environment, 
two versions of this program exist: the mainframe to which the MSF device is physically connected (the 
master mainframe) has a program called MSSEXEC, and all other mainframes (the slave mainframes) 
have a program called MSSSLV. Refer to Multimainframe Operation for more information. 

SUBFAMILY 

Each permanent file family consists of eight subfamilies, subfamily through subfamily 7. The lower 3 
bits of the user index identify the subfamily to which a user belongs. For example, a user whose index 
ends in 3 (or Oil in bit notation) belongs to subfamily 3. When the ASDEF utility is run to create MSS 
system files, the CSU maps are created under user index 377760s (subfamily 0) and one MSF catalog is 
created under each user index 37776ig (subfamily i), i=0,l,2,...,7. When the ASLABEL utility is used to 
assign a CSU, cubicle, or cartridge to a family, it is possible for the analyst to specify assignment only to 
particular subfamilies of the family. 

UTILITIES 

The following sections describe the MSS utilities. All of these utilities must be run from system origin 
jobs. In a multimainframe environment, the ASDEF and ASUSE utilities can be run on any mainframe 
that has access to the family being processed. However, the remaining utilities must be run on the 
mainframe on which MSSEXEC executes. 

ASDEF 

ASDEF creates the system files (CSU maps and MSF catalogs) that are necessary for MSS processing. If 
a CSU is added to the MSF hardware configuration, ASDEF is used to create the CSU map for that CSU. 
If a family is to be permitted to have MSF resident files, ASDEF is used to create the eight MSF catalogs 
for that family (one catalog for each subfamily). 
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NOTE 



If the CS parameter is specified, ASDEF will 
create a CSUMAP for the specified CSU (refer to 
the definition of CSUMAP). It is recommended 
that an installation make a copy of the CSUMAP 
on tape or on another device or family 
immediately after it is created. 



The format of the ASDEF control statement is as follows: 
ASDEF.p^. 

Pi Description 

CS=id CSU identifier of the CSU for which a CSU map is to be created; id is a letter 

from A to M. 

CS Same as CS=A. 

CS omitted No CSU map is to be created. FM=family or FM must be specified. 

FM=family Family for which MSF catalogs are to be created, one catalog for each 

subfamily. 

FM Same as FM=system default family. 

FM omitted No MSF catalogs are to be created. CS=id or CS must be specified. 

Example: 

ASDEF,CS=B. 

CSMAPB, the CSU map for CSU B, is created, and its entries are as described in the previous definition 
of CSU map. However, since ASDEF does not assign cubicles, the entries for cubicles available for use 
initially have zeros or spaces in all but the code field, which indicates the cubicles are unassigned. 

ASLABEL 

ASLABEL manages cartridge assignment and cubicle allocation in a CSU. The following functions are 
performed through the use of directives to ASLABEL. 

• Add a CSU to a subfamily (AC directive). 

• Remove a CSU from a subfamily (RC directive). 

• Add cubicles to a subfamily, the pool, or the reserved area (AB directive). 

• Remove cubicles from a subfamily, the pool, or the reserved area (RB directive). 

• Add cartridges to a subfamily or the pool (AM directive). 

• Remove cartridges from a subfamily or the pool (RM directive). 
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• Restore an abnormally removed cartridge (RS directive). 

• Repair a cartridge label or overwrite a family label (FX directive). 

• Inhibit or allow further allocation of files to a cartridge (IB directive). 

Input to ASLABEL is via a directive file. ASLABEL reads the appropriate CSU maps and MSF catalogs to 
determine how to process each directive and then issues requests to MSSEXEC to read and/or write 
cartridge labels and to update the CSU maps and MSF catalogs. ASLABEL generates a report detailing 
the action taken for each input directive. If the assignment information or cartridge label is not 
appropriate or conflicts with data in the CSU map or MSF catalog, the cartridge label information is 
included on this report and the cartridge is put into the output drawer. It may be possible to restore such 
a cartridge as described in Cartridge Restoration and Reuse in a later section. 



NOTE 



ASLABEL updates the CSUMAP for the specified 
CSU (refer to the definition of CSUMAP). It is 
recommended that an installation make a copy of 
the CSUMAP on tape or on another device or 
family immediately after each update. 
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The format of the ASLABEL control statement is as follows: 
ASLABEL,p 1 ,p 2 . 



PL 
I=filenam 

I 

I omitted 

L=filenam 

L 

L=0 

L omitted 

Z 

Z omitted 



Description 

File containing the directives to ASLABEL. 

Same as I=COMPILE. 

Same as I=INPUT. 

File on which listable output is to be written. 

Same as L=OUTPUT. 

No output file is to be generated. 

Same as L=OUTPUT. 

Directives are contained on the ASLABEL control statement. The I 
parameter is ignored. 

Directives are contained on the file specified by the I parameter. 



ASLABEL Directives 

The directives to ASLABEL can be specified on a separate file (specified by the I parameter) or after the 
ASLABEL control statement (Z specified). If on the input file, each directive must be specified on a 
separate line via the OP=directive option. Parameters for a directive are on the same line, are separated 
by commas, and end with a period: OP=directive, Pi,P2>»*>Pn* 

Example: 

ASLABEL,I=DIRFILE. 

DIRFILE is the directive file and contains the following directives. 

OP=AM,N=4,PK=D. 
OP=RM,V=VSN444,FM,SB=l. 

Two directives to ASLABEL are specified. OP=AM adds four cartridges to the pool of CSU A (CS 
parameter not specified). OP=RM removes the cartridge whose vsn is VSN444 from subfamily 1 of the 
default family. (Refer to the following descriptions of directives and parameters.) 

If the directives are contained on the control statement, they follow the statement terminator. The first 
character following the terminator is the separator. Any character that does not appear in any of the 
directives can be used as the separator character. Each directive must be preceded by the separator and 
terminated by a period. 
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Example: 

ASLABEL,Z./OP=AM,N=4,PK=D./OP=RM,V=VSN444,FM,SB=l. 

The slash is used as the separator. This statement performs the same functions as those in the preceding 
example. 

The following directives are available with ASLABEL. Some of these directives cause cartridges to be 
physically moved to and from cubicles and the input or output drawer (refer to OP=AM, OP=RM, OP=RS, 
and OP=FX). The remaining directives cause only logical operations to occur - updating the MSS system 
files. The descriptions of the parameters for these directives follow this section. 



Add CSUs 

OP=AC adds a CSU to a subfamily. The MSF catalog for the specified subfamily is updated to reflect 
that cartridges and permanent files for the subfamily can reside on the specified CSU. This directive, 
however, does not manipulate cartridges or cubicles. 



Remove CSUs 

OP=RC removes a CSU from a subfamily. The MSF catalog for the specified subfamily is updated to 
reflect that cartridges and permanent files for the subfamily cannot reside on the specified CSU. Before 
OP=RC can be specified, all cubicles in the specified CSU must have been removed previously from the 
family (refer to the OP=RB directive). This directive, however, does not manipulate cartridges or 
cubicles. 



Add Cubicles 

OP=AB adds an unassigned cubicle within a CSU to a subfamily (PT=F), the pool (PT=P), or the reserved 
area of the CSU (PT=R). More than one cubicle (N=n) can be added at a time. Specific cubicles (XI and 
YI options) can be added, but they must be currently unassigned. For PT=R, XI and YI must be used to 
add multiple cubicles; N=n is not valid. If cubicles are to be assigned to a subfamily, ASLABEL selects 
available cubicles closest to the top of the CSU. If cubicles are to be assigned to the pool, ASLABEL 
selects available cubicles closest to the bottom of the CSU. The CSU map is updated to reflect the new 
assignment of cubicles. 



Remove Cubicles 

OP=RB removes an assigned empty cubicle from a subfamily (PK=F), the pool (PK=P), or the reserved 
area of the CSU (PK=R). More than one cubicle (N=n) can be removed at a time. ASLABEL reads the 
CSU map and selects the first empty cubicle assigned to the subfamily, pool, or reserved area to be 
removed. Specific cubicles (XI and YI options) can be removed, but they must be empty. The CSU map 
is updated to reflect that the cubicles are unassigned. 



Add Cartridges 

OP=AM adds a cartridge with a manufacturer's label or a scratch label to either a specific subfamily 
(PT=F) or the pool (PT=P). ASLABEL selects the first empty cubicle assigned to the subfamily or pool as 
the new location for the cartridge. More than one cartridge (N=n) can be added at a time or a specific 
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cartridge (V=vsn) from the pool can be added to a subfamily. The CSU map, MSF catalog, and cartridge 
label are updated to reflect the new assignment of the cartridge. 



Remove Cartridges 

OP=RM removes either an empty cartridge from a subfamily to the pool or the output drawer (PK=F and 
PT=P or PT=D) or any cartridge from the pool to the output drawer (PK=P and PT=D). Any cartridge 
currently assigned to a subfamily cannot be removed unless it is empty; that is, all 16 streams must be 
unallocated. More than one cartridge (N=n) can be removed or a specific cartridge (V=vsn) from the pool 
can be removed to the output drawer. The CSU map, MSF catalog, and cartridge label are updated to 
reflect the change in location of the cartridge. The removed cartridge then has a scratch label, which 
allows it to be reassigned via the OP=AM directive. 

If the cartridge specified by the V parameter is lost (does not reside in its assigned cubicle), the LT 
option should be specified. This allows the appropriate entries in the CSU map and MSF catalog to be 
deleted even though the cartridge is not available to have its label updated. If LT is not specified, an 
error message is issued and ASLABEL aborts. 



Restore Lost Cartridges 

OP=RS restores to its proper cubicle a cartridge that was inadvertently removed from a CSU. If 
restoration is successful, the lost flag in the MSF catalog is cleared. If data recorded on the cartridge 
label does not agree with the information in the MSF catalog and the CSU map entry for the cubicle to 
which the cartridge is to be restored, the cartridge label information is reported and the cartridge is put 
into the output drawer for use in further processing of the cartridge. 



Fix Cartridge Labels 

OP=FX writes a scratch label on a cartridge and adds the cartridge to the pool. This directive is 
intended for use when a cartridge label has been destroyed, but the cartridge itself is not physically 
damaged and can be reused. It can also be used when a cartridge with a family label is to be assigned to 
a different subfamily via the OP=AM directive, but it is not feasible to first remove the cartridge 
normally via the OP=RM directive. For example, if ASLABEL is run to add a cartridge to a subfamily, 
and a system failure occurs before the MSF catalog and CSU map are updated but after the cartridge is 
relabeled, then the cartridge label does not match the corresponding entries in the MSF catalog and CSU 
map. Hence, OP=RM cannot be used to remove the cartridge from the subfamily, but OP=FX can be used 
to rewrite the cartridge label and then OP=AM can be used to add the cartridge to a subfamily. 
However, if a family label is to be overwritten, the FM and SB parameters must identify the family and 
subfamily to which the cartridge was assigned. The CSU map and MSF catalog are updated to reflect the 
new cartridge label. 



Control Cartridge Allocation 

OP=IB sets or clears the inhibit allocation flag in the MSF catalog entry for the specific cartridge (V=vsn 
must be specified). If the flag is set (ON), MSSEXEC does not allocate new MSF files to this cartridge. 
If the flag is cleared (OF), allocation of files to this cartridge is enabled. 
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Parameters for ASLABEL Directives 

The descriptions of the parameters to the ASLABEL directives follow. Not all options are valid with all 
directives, as indicated. 



Pi 
CS=id 

CS 

CS omitted 

D=d 

D 

D omitted 
FM=family 

FM 

FM omitted 

LT 

LT omitted 

N=n 

N 

N omitted 

OF 

ON 
PK=pkloc 



Description 

CSU identifier of the CSU to be used by ASLABEL; id is a letter from A to M. 

Same as CS=A. 

Same as CS=A. 

Input drawer slot from which ASLABEL picks the cartridge; valid only with 
OP=AM, OP=RS, or OP=FX. 

First nonempty input drawer slot is to be used; valid only with OP=AM, 
OP=RS, or OP=FX. 

Same as D. 

Family to which ASLABEL adds or from which it removes a cartridge or 
CSU. With OP=FX, this parameter specifies the family to which the 
cartridge was assigned. 

Same as FM=system default family. 

Same as FM=system default family. 

CSU map and MSF catalog entries are to be updated, even though the 
cartridge is lost and its label cannot be updated; valid only with OP=RM. 

If the cartridge is lost and OP=RM is specified, an error message is issued and 
ASLABEL aborts. 

Number of cartridges or cubicles to be added, removed, or repaired; 
l<n<2000; not valid if PT=R is specified. If V=vsn is specified, n must be 1. 

Same as N=l. 

Same as N=l. 

Inhibit allocation flag in the MSF catalog is to be cleared; valid only with 
OP=IB. 

Inhibit allocation flag in the MSF catalog is to be set; valid only with OP=IB. 

Location from which the cartridge or cubicle is to be picked; not valid if 
V=vsn is specified. 

pkloc Description 

D Cartridge is to be picked from the specified input drawer slot 

(D=d). PK=D is valid only with OP=AM, OP=RS, or OP=FX. 

F Cartridge or cubicle is to be picked from the specified family 

(FM=family) and subfamily (SB=sub). PK=F is valid only with 
OP=RM or OP=RB. 
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Pi 



Description 



PK 

PK omitted 

PT=ptloc 



PT 

PT omitted 

SB=sub 

SB 

SB omitted 

V=vsn 

V 

V omitted 

XI=X! 

YI=yi 



pkloc Description 

P Cartridge or cubicle is to be picked from the pool. PK=P is 

valid only with OP=AM, OP=RM, or OP=RB. PK=P is not valid 
if PT=P is specified. 

R Cubicle is to be picked from the reserved area of the CSU. 

PK=R is valid only with OP=RB. 

Same as PK=P. 

Same as PK=P. 

Location into which the cartridge or cubicle is to be put. 

ptloc Description 

D Cartridge is to be put into the first available output drawer 

slot. PT=D is valid only with OP=RM. 

F Cartridge or cubicle is to be put into the specified family 

(FM=famiiy) and subfamily (SB=sub). PT=F is valid only with 
OP=AM or OP=AB. 

P Cartridge or cubicle is to be put into the pool. PT=P is valid 

only with OP=AM, OP=RM, or OP=AB. PT=P is not valid if 
PK=P is specified. 

Cubicle is to be put into the reserved area of the CSU. PT=R 
is valid only with OP=AB. 



R 

Same as PT=P. 

Same as PT=P. 

Subfamily to which ASLABEL adds or from which it removes a cartridge or 
CSU; 0<sub<7. With OP=FX, this parameter specifies the subfamily to which 
the cartridge was assigned. 

Same as SB=0. 

Same as SB=0. 

Volume serial number of the cartridge to be added, removed, or repaired; not 
valid if PK=pkloc is specified. If V=vsn is specified, n must be 1 if N=n is 
specified. 

Volume serial number of the cartridge is not specified. 

Same as V. 

Column of the CSU to be added or removed; 0<xi<57, X]^30; valid only with 
OP=AB or OP=RB. 

Row of the CSU to be added or removed; 0<yi<36, y2^18; valid only with 
OP=AB or OP=RB. 
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Pi Description 

XI=xi,YI=yi X and Y coordinates of the cubicle to be added or removed; 0<xi<57, 

0<yi<36, x;|*30, yi#18; valid only with OP=AB or OP=RB. 

XI= Xl ,YI= yi , 

XF=X2,YF=y2 Rectangle of cubicles to be added or removed; cubicles with X coordinates 

between x\ and X2 and Y coordinates between yj and y2 are included; valid 
only with OP=AB or OP=RB. At most, 100 cubicles can be included in the 
rectangle. X!,x 2 <57, X!,x 2 *30; yi,y2^36, yi,y2*18; X!<x 2 ; yi<y2- XF and 
YF must both be specified, if either is. XF and YF cannot be specified unless 
both XI and YI are specified. 

XI and YI omitted With OP=AB, the next available cubicle closest to the top (for assignment to 
a family) or the bottom (for assignment to the pool) is to be selected. With 
OP=RB, the first empty assigned cubicle is to be selected. 

ASLABEL Update Sequence 

The general result of each directive to ASLABEL is the updating of the CSU maps, MSF catalogs, and 
cartridge labels, whichever are appropriate, to reflect the changes in cartridge, cubicle, or CSU 
assignment. Because the MSF catalog is a disk resident permanent file, it will be backed up on a dump 
tape whenever PFDUMP dumps the master device for its particular subfamily. Thus, it is not necessary 
for the analyst to back up the MSF catalogs immediately after an ASLABEL run. However, the backup 
and recovery of CSU maps do require special operational procedures, which should be performed 
immediately after an ASLABEL run (refer to the definition of CSU map). 

When ASLABEL is run to change the assignment of a cartridge, the update sequence consists of a series 
of steps to delete the old assignment information from the MSS system files, relabel the cartridge, and 
add the new assignment information to the MSS system files. If an interruption such as a system failure, 
ASLABEL abort, or MSSEXEC abort prevents ASLABEL from completing the update sequence, the 
location of the affected cartridge and the status of the CSU maps and MSF catalogs depend on the point 
of interruption as follows: 

• If the cartridge label, MSF catalog, and CSU map do not all match, then the cartridge is put 
into the output drawer. The OP=RS directive cannot be used to restore the cartridge because of 
the inconsistency. However, OP=FX can be used to overwrite the cartridge label and add the 
cartridge to the pool, if the FM and SB parameters specify the family and the subfamily on the 
cartridge label. 

• If the cartridge label, MSF catalog, and CSU map do match, then the cartridge may be returned 
to its original location, the new location, or the output drawer depending on the exact point of 
interruption. If the cartridge is in the output drawer, OP=RS can be used to restore the 
cartridge to the location indicated on the cartridge label. 

Cartridge Restoration and Reuse in a later section describes the procedure for restoring cartridges found 
in the output drawer. 



Restrictions to ASLABEL 

The following restrictions apply to the ASLABEL utility. 

• MSSEXEC must be running when ASLABEL is run. 

• Only one copy of ASLABEL can be run at a time. 

• ASLABEL, ASVAL, and ASDEBUG cannot be run at the same time. 
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Example 

The following output shows the format of an ASLABEL report. The cartridge label information is 
included on the report because of a mismatch with the CSU map. An error message is issued for the first 
directive on the control statement (in this case, the only directive). 

ASLABEL REPORT FILE 
ASLABEL,Z./OP=RS,PK=D,CS=B. 

1 OP=RS,PK=D,CS=B. 

1 OP=RS,PK=D,CS=B. 

VSN = P66157 
FAMILY = SYSTST 
SUBFAMILY = 
CSU = B 
X = 2 
Y = 6 
" ;::: ERROR 8 DIRECTIVE 1 

UNEXPECTED CSU, X, Y, FAMILY OR SUBFAM,"— 



ASMOVE 

ASMOVE manages disk and MSF residence. That is, ASMOVE determines which files should be left on 
disk, which files should be released from disk and moved to MSF, and which files should be resident both 
on disk and on MSF. The ASVAL utility, not ASMOVE, controls the releasing of MSF space. 

The selection process includes two algorithms that weigh certain file characteristics as follows: 

• Files are selected for destaging to MSF based on file length, time since the last update, and the 
preferred residence specified by the user. 

• Files are selected for release from disk based on time since the last access and the backup 
requirement specified by the user. 

ASMOVE reads the PFC entries for a particular family and calculates release and destage values (refer 
to Selection Algorithms later in this section) for each file to determine its residence. If a file has both 
disk and MSF images but is to reside only on MSF, ASMOVE releases the disk space for the file.. For files 
that do not have an MSF image, ASMOVE creates entries on the ASMOVE/MSSEXEC communication file, 
MOVCOM, to identify the files to be destaged and to specify whether or not the file's disk space is to be 
released upon completion of the destage. MSSEXEC then processes each destage and destage/release 
request on MOVCOM. 
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ASMOVE generates an output report that lists the files released by ASMOVE and the files contained on 
MOVCOM. A report on the use of disk space before and after the ASMOVE run is included in the output 
file and the dayfile. 

The format of the ASMOVE statement is as follows: 

ASMOVE^pg,...,^. 



FM=family 

FM 

FM omitted 

L=filenam 

L 

L=0 

L omitted 

RD=yymmdd 

RD omitted 
RO 

RO omitted 

RT=hhmmss 

RT 

RT omitted 

TM=mode 



Description 

Family to be used by ASMOVE. 

Same as FM=system default family. 

Same as FM=system default family. 

File on which listable output is to be written. 

Same as L=OUTPUT. 

No output file is to be generated. 

Same as L=OUTPUT. 

Last access date. All files not accessed after yymmdd are to be released 
from disk. 

No files are to be released. 

Report only. ASMOVE does not release files from disk and does not send 
requests to MSSEXEC to destage or destage /release files. 

Disk space is to be released and requests are to be sent to MSSEXEC, if 
appropriate. 

Last access time. All files not accessed after hhmmss of the day 
specified by the RD parameter are to be released. 

Same as RT=000000 (midnight). 

Same as RT=u00000 (midnight). 

Selects or deselects test mode (refer to Pseudo-Release in a later 
section). 



Mode 



Description 



TM omitted 



Y Select test mode. Pseudo release of all files selected for 

release from disk by this ASMOVE run is performed. 

N Deselect test mode. The pseudo release flag is cleared 

and disk images for all files from the selected family 
which were previously pseudo-released are really released 
from disk. Normal release processing is performed for all 
files selected for release from disk by this ASMOVE run. 

Normal release processing is to be performed for files that do not have 
the pseudo release flag set. Files with the pseudo release flag set are 
treated as if they have already been released. 
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The following options for ASMOVE redefine the values of the weight factors or thresholds (installation 
parameters) used in the algorithms that select files to be destaged or released. The installation uses 
these options to increase or decrease the importance of certain file characteristics used to determine 
which files are to be destaged and/or released. For example, specifying a large MN parameter prohibits 
ASMOVE from selecting small files for destaging to MSF. Unless otherwise stated, each of these options 
causes the installation-defined value to be multiplied by the integer value n, n>0. Refer to the NOS 
Installation Handbook for the initial definitions of these values. 



Option 
DB=n 

DB 

DB omitted 

DC=n 

DC 



Description 

n times the installation-defined DB weight factor is to be used as the 
preferred residence value for destage decisions involving files with a PR=M 
attribute.! 

Same as DB=1. 

Same as DB=1. 

n times the installation-defined weight factor is to be used as the preferred 
residence value for destage decisions involving files with a PR=N attribute, t 

Same as DC=L 



uu omitted 
DL=n 

DL" 

DL omitted 

DT=n 

DT 

DT omitted 

DV=n 

DV 

DV omitted 

MN=n 

MN 

MN omitted 

MX=n 



Same as lkj=1. 

n times the installation-defined length weight factor is to be used as the 
length weight factor for destage decisions. 

Same as DL=1. 

Same as DL=1. 

n times the installation-defined time weight factor is to be used as the time 
weight factor for destage decisions. 

Same as DT=1. 

Same as DT=1. 

n times the installation-defined destage control value is to be used as the 
destage control value. 

Same as DV=1. 

Same as DV=1. 

n times the installation-defined minimum length threshold is to be used as the 
minimum allowable size in disk PRUs (64 words) for MSF files. 

Same as MN=1. 

Same as MN=1. 

n times the installation-defined maximum length threshold is to be used as 
the maximum allowable size in disk PRUs for MSF files. 



t The file owner specifies the preferred residence attribute via the PR parameter on the DEFINE or 
CHANGE statement (refer to volume 1 of the NOS Reference Manual). 
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Option Description 

MX Same as MX=1. 

MX omitted Same as MX=1. 

Selection Algorithms 

ASMOVE determines which files to destage and/or release according to the following algorithms. Files 
that reside only on MSF are not considered because they have been destaged and released previously. 
Also, indirect access files are excluded from consideration because they cannot reside on MSF. For all 
other files, ASMOVE checks the file length and excludes from further consideration any file whose length 
in PRUs is less than the minimum length threshold (refer to the MN parameter) or greater than the 
maximum length threshold (refer to the MX parameter). 

If the current image of the file resides on both disk and MSF, ASMOVE uses the release algorithm to 
determine whether or not to release disk space; the destage algorithm is not used. If the current file 
resides on disk only, ASMOVE uses the destage algorithm to determine whether or not to destage the 
file. If the file is to be destaged to MSF, ASMOVE also determines via the release algorithm whether or 
not to release the file's disk space. 

Destage Algorithm 

The destage algorithm is used to select for destaging certain files that do not have current MSF images. 
ASMOVE calculates the destage value for each eligible file according to the following equation. If the 
destage value exceeds the destage control value (refer to the DV parameter), ASMOVE selects the file 
for destaging. Otherwise, the file remains on disk only. 

destage value = (1 + t * time) * (1 + 1 * length) * (res) 

t Installation-defined time weight factor. 

time Number of days since the file was last modified. 

H Installation-defined length weight factor. 

length Length of the file in PRUs. 

res Installation-defined preferred residence value. This value depends on whether the file 

owner specified no preferred residence or MSF residence preferred for the file. Refer 
to the DB and DC parameters. 

Release Algorithm 

The release algorithm is used to select files whose disk space is to be released. Any file with a backup 
required (BR=Y)t attribute and whose master device has not been dumped since the file was last 
modified is not considered for disk space release. The date and time the master device was last dumped 
was set by the SD parameter on PFDUMP. For all other files, ASMOVE checks the last access date and 
time in the PFC entry for each file. If the file was last accessed before the date and time specified by 
the RD and RT parameters, its disk space is to be released. If the file to be released has a current MSF 
image, ASMOVE releases the disk space. If the file to be released does not have a current MSF image, 
MSSEXEC creates one before releasing the disk space. 



t The file owner specifies the backup requirement via the BR parameter on the DEFINE or CHANGE 
statement (refer to volume 1 of the NOS Reference Manual). 
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Disk Space/Dump Tape Management 

As more disk resident files are created and more MSF resident files are staged to disk, it will be 
necessary for the installation to monitor the availability of disk space. It is recommended that ASMOVE 
be used as a periodic disk space management procedure to avoid frequent disk full conditions (refer to 
Disk Space Management in a later section). ASMOVE can also be used to reduce the amount of data 
written on dump tapes and thereby avoid maintaining large numbers of dump tapes. This is accomplished 
by destaging to MSF and/or releasing disk space of files that need not be on the dump tape (refer to 
Dump Tape Management in a later section). 

Restrictions to ASMOVE 

Only one copy of ASMOVE can be run at a time. A second ASMOVE aborts if the first one has not 
completed. 

Example 

The following output shows the format of an ASMOVE report. The files that are to be destaged and 
destaged/released are listed. An account of the disk space and the destage for backup, release date, and 
release time values are given. 

ASMOVE REPORT. 

ASMOVE,FM=SYSTST,L=MOV,RD=791109,RT=08 55^7,MN=1,MX=9999,TM=Y 
FILE UI LENGTH 



AAAAAA I 


172 


22 


RELEASE 


AND 


DESTAGE 


AAAAAAJ 


172 


22 


RELEASE 


AND 


DESTAGE 


AAAAAAK 


172 


7 


RELEASE 


AND 


DESTAGE 


AAAAAAL 


172 


29 


RELEASE 


AND 


DESTAGE 


AAAAAAM 


172 


41 


RELEASE 


AND 


DESTAGE 


AAAAAAN 


172 


50 


RELEASE 


AND 


DESTAGE 


AAAAAAO 


172 


43 


RELEASE 


AND 


DESTAGE 


AAAAAAP 


172 


31 


RELEASE 


AND 


DESTAGE 


AAAAAA Q 


172 


27 


RELEASE 


AND 


DESTAGE 


AAAAAAR 


172 


34 


RELEASE 


AND 


DESTAGE 


AAAAAAS 


172 


16 


RELEASE 


AND 


DESTAGE 


DEF0002 


170 


78 


RELEASE 


AND 


DESTAGE 


AAAOAAA 


172 


19 


RELEASE 


AND 


DESTAGE 


AAAEAAA 


172 


17 


RELEASE 


AND 


DESTAGE 


AAA P AAA 


172 


20 


RELEASE 


AND 


DESTAGE 


MOV0040 


170 


6 


RELEASE 


AND 


DESTAGE 


MOV0005 


170 


6 


RELEASE 


AND 


DESTAGE 


DLF0006 


170 


4 


RELEASE 


AND 


DESTAGE 


DLF0012 


170 


70 


RELEASE 


AND 


DESTAGE 


DMP0012 


170 


160 


RELEASE 


AND 


DESTAGE 


RDF0012 


170 


59 


RELEASE 


AND 


DESTAGE 


CLF0012 


170 


5 


RELEASE 


AND 


DESTAGE 


DWK0013 


170 


1065 


RELEASE 


AND 


DESTAGE 


WLF0013 


170 


29 


RELEASE 


AND 


DESTAGE 


MOV0014 


170 


7 


RELEASE 


AND 


DESTAGE 


DEF0015 


170 


692 


RELEASE 


AND 


DESTAGE 


DLF0017 


170 


78 


RELEASE 


AND 


DESTAGE 


CLF0017 


170 


5 


RELEASE 


AND 


DESTAGE 


STIMABS 


170 


103 


DESTAGE 
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GLOSARY 
AAAVAAA 
DMP0017 
RDF0017 
DWK0018 
WLF0018 
RPT0019 
MOV0020 
DLF0021 
DMP0021 
RDF0021 
RPT0022 
DEF0023 
AAAXAAA 
AAAYAAB 
AAAYAAC 



172 
172 
170 
170 
170 
170 
170 
170 
170 
170 
170 
170 
170 
172 
172 
172 



ACTPFSPACE BEFORE PROCESSING = 
ACTPFSPACE AFTER PROCESSING = 
PF SPACE RELEASED 
RELEASE DATE USED 
RELEASE TIME USED 



66 


DESTAGE 


14 


DESTAGE 


287 


DESTAGE 


59 


DESTAGE 


1089 


DESTAGE 


31 


DESTAGE 


119 


DESTAGE 


8 


DESTAGE 


107 


DESTAGE 


481 


DESTAGE 


60 


DESTAGE 


150 


DESTAGE 


687 


DESTAGE 


12 


DESTAGE 


13 


DESTAGE 


14 


DESTAGE 


NG = 


6488 


G = 


3846 


= 


2642 


= 


79/11/09. 


= 


08.55.47. 



ASVAL 

ASVAL either performs release processing or reports on problems with the current MSS system files. 
That is, it either makes available MSF space presently allocated to files that are no longer needed, or 
reports on irregularities or discrepancies found in the current MSF catalogs and PFC entries for the 
specified family and, optionally, in certain CSU maps. The function to be performed is determined by 
whether or not the RF option is specified, as described below. 



NOTE 



ASVAL updates the CSUMAP for the specified 
CSU. (Refer to the definition of CSU map.) It is 
recommended that an installation make a copy of 
the CSU map on tape or on another device or 
family immediately after every update of the CSU 
map. 



Release Processing 

If RF=filenam or RF is specified, ASVAL determines which MSF files are no longer needed and issues a 
request to MSSEXEC to purge these files so their MSF space can be reused. The procedure is for ASVAL 
to analyze copies of the MSF catalogs and PFC entries for the specified family that are contained on the 
release data file (RDF) specified by the RF parameter. Those MSF files described in an MSF catalog but 
not having a PFC entry (that is, orphans) can be purged. During the analysis (refer to MSF Catalog 
Analysis and PFC Analysis later in this section), ASVAL keeps track of the error conditions it discovers, 
and if the error count is less than or equal to the threshold specified by the FX parameter, release 
processing is performed if RL is specified. That is, trouble-free orphans are purged and their MSF space 
is made available for reuse. The current MSF catalog is updated to reflect that these files no longer 
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exist. A validation report is issued which lists the errors encountered, the number of trouble-free 
orphans, and the amount of released MSF space. If RL is not specified, no release processing is 
performed but the validation report is issued, which lists the errors encountered, the number of 
trouble-free orphans, and the amount of releasable MSF space. 

The RDF used for this analysis is a file produced during a previous PFDUMP run and it contains versions 
of the MSF catalogs and PFC entries that were current at the time of the dump. The installation chooses 
which RDF to use depending on how long after a file was purged it wants to wait before releasing its MSF 
space. For example, an installation might run ASVAL every week for release processing purposes and use 
the RDF from the previous week's full dump. There are some restrictions as to which RDFs can be used 
(refer to MSF Space Management in a later section). The capability to release trouble-free orphans by 
analyzing the current MSF catalogs and PFC entries is not provided in order to ensure that an MSF file is 
released from MSF only after it is no longer needed. 



Problem Reporting 

If RF=filenam or RF is not specified, ASVAL reports on problems with the current MSF catalogs and PFC 
entries for the specified family. If AM is specified, problems with CSU maps are also included in the 
report. ASVAL examines the MSS system files and PFC entries and searches for problem chains and 
fragments, problem asa values, and CSU map/MSF catalog mismatches. The procedures ASVAL uses to 
detect and classify inconsistencies and discrepancies are described later in this section (refer to Error 
Detection and Classification). ASVAL keeps track of the error conditions, if any, it discovers, and if the 
error count is less than or equal to the threshold specified by the FX parameter, problem fixing is 
performed. That is, ASVAL sets flags in the appropriate entries of the CSU map, MSF catalog, and/or 
PFC entries to prevent propagation of errors due to the inconsistencies or discrepancies found and to 
permit error recovery by the ASDEBUG utility. A count of the errors is recorded in the dayfile. A 
validation report is issued which lists the errors encountered, the number of trouble-free orphans, and the 
amount of releasable MSF space. 

The format of the ASVAL control statement is as follows: 



ASVAL,P!,P2,...,Pn. 

Pi 

AM 

AM= 

AM omitted 

CS=id 

CS 

CS omitted 

FM=family 

FM 

FM omitted 



Description 

The CSU map for the CSU specified by the CS parameter is to be analyzed in 
addition to the MSF catalogs; not valid if RF=filenam or RF is specified. 

Same as AM. 

CSU maps are not to be analyzed. 

CSU identifier of the CSU to be used. Up to 13 CSUs can be selected by the 
letters A through M. For example, CS=ACJG selects CSU A, C, G, and J. 

Same as CS=ABCDEFGHIJKLM. 

Same as CS=ABCDEFGHIJKLM. 

Family to be analyzed; not valid if the RF option is specified. 

Same as FM=system default family; not valid if the RF option is specified. 

Same as FM=system default family, if the RF option is not specified. The 
family on the release data file is used, if the RF option is specified. 
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Pi 



Description 



FX=n 

FX 

FX omitted 

L=filenam 

L 

L=0 

L omitted 

RF=filenam 

RF 

RF omitted 

RL 

RL omitted 

SB=sub 

SB 

SB omitted 

ST=n 



ST 

ST omitted 



Error threshold. If the total error count is greater than n, neither release 
processing nor problem fixing is performed. 

Same as FX=0. 

Same as FX=0. 

File on which listable output is to be written. 

Same as L=OUTPUT. 

No output file is to be generated. 

Same as L=OUTPUT. 

File which contains the release data file. 

Same as RF=ZZZZRDF. 

Current versions of the MSF catalogs are to be analyzed. 

Release processing is to be performed; valid only if the RF option is specified. 

No release processing is to be performed. 

Subfamily to be processed. Up to eight subfamilies can be selected by the 
numbers through 7. For example, SB=723 selects subfamilies 2, 3, and 7. 

Same as SB=01234567. 

Same as SB=01 234567. 

Scattered file criterion. Files are indicated as scattered if they are 
contained on at least n more cartridges than the minimum number needed to 
contain them. The minimum number of cartridges is the quotient of (number 
of streams + 15)/16; the remainder is ignored. For example, if the file is 
contained on 100 streams and 10 cartridges, it is scattered if n=l but is not 
scattered if n=5. 

Same as ST=0. That is, files are scattered if they are contained on more than 
the minimum number of cartridges needed to contain them. 

Same as ST=0. 



Error Detection and Classification 

ASVAL detects and classifies errors according to the following procedures. During the CSU map 
analysis, ASVAL detects and classifies errors in the CSU map. During the MSF catalog analysis, ASVAL 
detects errors with chains of AUs and during the PFC analysis, ASVAL classifies these errors. Whenever 
an error is encountered, the total error count is increased by one. The action taken for each type of 
error is discussed in Release Processing and Problem Fixing later in this section. 
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CSU Map Analysis 

If the AM option is specified, ASVAL attempts to locate problems with CSU map entries by comparing 
the MSF catalogs and the CSU map. For each X,Y coordinate pair in an MSF catalog entry, ASVAL 
locates the corresponding CSU map entry. A type 1 error exists if the code field in the CSU map entry is 
not 5 (assigned to a subfamily), or if the family, subfamily, or vsn fields in the CSU map entry do not 
match those in the corresponding MSF catalog entry. ASVAL also scans the CSU map for all other 
entries assigned to the subfamily and reports as a type 2 error any of these entries that does not have a 
corresponding MSF catalog entry. 



MSF Catalog Analysis 



The MSF catalog analysis locates problems with chains of AUs (refer to the definition of cartridge) and 
identifies on each HOC whether any of the following problems exist or whether any part of the MSF files 
resides on a cartridge which is lost or has excessive write parity errors. 

ASVAL scans the MSF catalog for HOC entries that are allocated and follows each chain until it 
terminates. Normal termination occurs with an EOC entry. Abnormal termination occurs when no EOC 
is found, but rather an illegal link value exists, an AU links to an unallocated stream, or an AU links to an 
AU previously found in the chain being followed (looping chain). 

During the chain scans, the following types of chains can be encountered; they are linkage problems that 
are identified on the HOC entry. 

Intersecting chain More than one chain links to the same AU. 

Scattered file chain The number of cartridges used for the file exceeds the value specified by 

the ST parameter plus the minimum number of cartridges needed for the 
file. 

ASVAL also locates any AUs that are allocated but were not on any chain being followed. Such AUs are 
linked together to form partial chains without an HOC. These partial chains are called fragments and 
the first AU in a fragment is designated as the start of fragment. Each fragment chain is followed until 
it terminates. The abnormal termination conditions previously listed can also occur with fragments. 
Intersections can occur, but a fragment chain that intersects the start of another fragment chain is not 
an intersection; rather, one is the tail end of the other. 



PFC Analysis 

The PFC analysis is performed to classify the errors encountered on chains during the MSF catalog 
analysis. For each PFC entry with asa#) (the file has an MSF image and the asa value identifies the first 
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AU in the chain containing the file), ASVAL classifies the following errors. Error type 3 exists if the asa 
value is illegal. Error type 4 exists for any of the following reasons. 

• The AU specified by the asa value is not allocated or is not an HOC entry. 

• The chain does not terminate normally. 

• The chain intersects with another chain or fragment. 

• More than one PFC entry points to the chain. 

• The chain includes a cartridge for which the lost or excessive parity error flag is set. 
ASVAL also classifies the following error conditions. 

• Error type 5 exists if an orphan chain terminated abnormally or intersects with other chains or 
fragments. Trouble-free orphans (chains without a PFC entry pointing to them and without 
linkage problems) are not classified as errors. 

• Error type 6 exists if an orphan is a fragment. 

• Error type 7 exists if a chain or fragment points to an unallocated AU. 

ASVAL generates informational report messages if either of the following conditions is true. 

• The system error flag is set in the PFC. 

• The read error flag is set in the PFC. 

Release Processing and Problem Fixing 

If the total error count calculated during the analyses described previously exceeds the value specified by 
the FX parameter, then neither release processing nor action to flag or fix the detected error conditions 
is performed. The validation report, however, is produced. Otherwise, action taken depends on the 
parameter specified and the type of errors found, as follows. 

If ASVAL was run for release processing purposes (RF=filenam or RF specified), ASVAL issues a request 
to MSSEXEC to release trouble-free orphans if RL was specified. If RL was not specified, no release 
processing is performed. If ASVAL was run for problem reporting purposes (RF omitted), the following 
action is taken. 

• For error type 1, the linkage error flag is set in the MSF catalog entry. 

• For error type 2, the linkage error flag is set in the CSU map entry. 

• For error type 3, there are two alternatives. If the file also has a disk image, the asa field in 
the PFC entry is cleared. Thus, the good disk image will not be released and the file is 
accessible even if the MSF image cannot be retrieved. If the file does not have a disk image, no 
action is taken. However, if the disk image can be reloaded from tape, it is recommended that 
the file be reloaded and that ASVAL then be rerun to clear the asa field in preparation for other 
corrective action. 

• For error type 4, the action taken is both that taken for error type 3 and that taken for error 
types 5, 6, or 7. 

• For error types 5, 6, or 7, the frozen flag is set in the MSF catalog entry for the initial AU on 
the problem chain or fragment. This enables the problem chain/fragment/AU to be made 
available to the ASDEBUG utility, but prevents these AUs from being overwritten until then. 
Thus, the ASDEBUG utility can be used to inspect or save data from the corresponding streams 
or cartridges. 
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Validation Report 

The validation report consists of a report heading and a series of report groups for each subfamily and 
CSU being reported on. The heading identifies the subfamily, the CSU, whether or not there are any 
problems, and the last purge date and time for the CSU (the last time orphans on this CSU were 
released). There is one report group for each error detected, and the actual information recorded in a 
report group depends on the type of error as described in the following paragraphs. Each report group, 
however, contains the following items. 

• Error type (a number from 1 to 7). 

• Identification (refer to the particular error type below). 

• Chain information (MSF catalog ordinal, stream number, A or U designation for allocated or 
unallocated, H or E designation for HOC or EOC). 

• Error description 

After the last report group, the validation report lists the number of trouble-free orphans, the amount of 
released or releasable MSF space, the total number of errors detected, and whether or not the MSS 
system files were updated. 



Error Types 1 and 2 

Error types 1 and 2 identify mismatches between the CSU map and the MSF catalog. In the validation 
report, the identification field lists the MSF catalog ordinal, the X and Y coordinates, and the vsn of the 
cartridge in error. The chain field is blank because problem chains are not identified as either error type 
1 or 2. The analyst should run the ASUSE utility to produce a detailed report of the appropriate CSU 
map and MSF catalog entries to determine the exact problem. 



Error Types 3 and 4 

Error types 3 and 4 identify problem chains and problem asa values. In the validation report, the 
identification field lists the permanent file name and user index of the affected file; the dump control 
date and time (from the PFC entry for the file) to identify the backup file, if any; and the letter N (no) 
or Y (yes) to indicate whether or not the file has a disk image. The chain field lists the MSF catalog 
ordinal and stream number for all AUs in the affected chain. An A or U indicates whether each AU is 
allocated or unallocated, and an H or E identifies the HOC or EOC. An error description is printed for 
each error detected; one chain can have several errors. 



Error Types 5, 6, and 7 



Error types 5, 6, and 7 identify problem orphans, fragments, and problem unallocated AUs. In the 
validation report, the information reported is the same as for error types 3 and 4, except for the 
identification field. Instead of the permanent file identification, the word ORPHAN (error type 5), 
FRAGMENT (error type 6), or UNALLOCATED (error type 7) is printed. Error type 7 is an unallocated 
AU that is pointed to by a chain or fragment. Each such AU is also reported with the chain for the 
corresponding orphan or fragment. 
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Intersections 

Intersections occur when more than one chain links to the same AU; they are classified as either error 
type 4 or 5. Thus, they are reported as explained previously. Intersections are also reported in a 
separate entry consisting of a heading and additional information identifying the MSF catalog ordinals 
and stream numbers of the intersecting chains. Therefore, when intersections are reported, there are 
two entries for the affected subfamily and CSU: one lists only the intersections and the other lists all 
the errors encountered. 



Example 

The following output shows the format of a validation report. ASVAL was run for problem reporting 
purposes (RF not specified), and no errors were detected. 



ASVAL - VALIDATION REPORT ASVAL - VER 1.0 

FAMILY = SYSTST 



ASVAL, FM=SYSTST,SB=0,CS=J. 

L = OUTPUT 

RF = 

AM = 

CS = J 

FM = SYSTST 

FX = 

RL = 

SB = 

ST = 



SUBFAMILY = CSU = J ~ GOOD -- LPDT 

RELEASABLE MSS FILES = 12 

RELEASABLE MSS STREAMS = 16 

TOTAL VALIDATION ERRORS = 
CATALOGS NOT MODIFIED 

""REPORT COMPLETE"" 
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Typical ASVAL Runs 

As described previously, ASVAL is run either to make MSF space available for reuse or to report on 
problems with the current MSS system files and/or PFC entries. The following examples show typical 
ASVAL runs that an installation might use periodically for these purposes. 



Example: 

The following call to ASVAL causes MSF space to be made available for reuse. 

ASVAL (RF=DUMP1,RL) 

DUMP1 is the release data file produced by a previous PFDUMP run from which ASVAL can identify all 
the MSF files that were orphans at the time of the dump. If no error conditions are detected in the MSF 
catalog and PFC entries contained on file DUMP1 (FX=0 by default), the orphans are purged and the MSF 
space assigned to them is released. The last purge date and time field in the subcatalog (in the MSF 
catalog) for each CSU for each subfamily is updated to the time of the ASVAL run if any file from that 
CSU is purged. This is to ensure that a subsequent ASVAL run does not release the same space a second 
time, as the MSF space may be reallocated to a new file. 

If errors were detected, they are listed on the validation report and release processing is not performed. 
This is indicated by the CATALOGS NOT MODIFIED message at the end of the validation report. The 
analyst can rerun ASVAL with the following call to ensure that release processing is performed (n is the 
number of errors detected during the previous ASVAL run). 

ASVAL (RF=DUMPl,RL,FX=n) 

After this ASVAL run has completed, an analysis of the current version of the CSU map, MSF catalog, 
and PFC entries should be made to determine whether or not the errors detected in the first ASVAL run 
exist in the current MSS system files and PFC entries. This is accomplished through the following 
statement. 

ASVAL (FM=family,AM) 

where family is that on the release data file, DUMP1. 



Example: 

Upon completion of any device reload which includes recovery of an MSF catalog and/or CSU map, 
ASVAL should be run to determine whether any CSU map/MSF catalog mismatches exist. The following 
call accomplishes this. 

ASVAL (FM=family,SB=n in2 ...n h ,AM) 

where family is that for which recovery was done and n l5 n2,...,nh are the affected subfamilies if just 
some of the devices of the family were reloaded. 

ASVAL analyzes the CSU map, MSF catalog, and PFC entries for the subfamilies specified by the SB 
parameter and reports any discrepancies or inconsistencies. For example, if the recovery was not 
scheduled and ASLABEL was run to add or remove cartridges or cubicles from one of the affected 
subfamilies after the last incremental or full dump for these subfamilies, then the CSU map will reflect 
the results of the ASLABEL run but the MSF catalog will not. Such mismatches will be reported on the 
validation report. 
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If the following call to ASVAL is then made, the errors detected during the previous run will be flagged 
as described previously in Release Processing and Problem Fixing. 

ASVAL(FM=family,SB=n 1 n 2 ...n n ,AM,FX=n) 

where family and n 1 ,n 2 ,...,n n are the same as in the previous ASVAL run and n is the number of errors 
detected during the previous run. After investigating the cause of these errors, the analyst can run the 
ASDEBUG utility to correct the error conditions (refer to ASDEBUG). 

If a device reload includes recovery of all CSU maps (default family, user index = 377760 8 ), the latest 
CSU maps should be recovered from backup copies. Then each family that has MSF-resident files should 
be analyzed via the following statement to detect CSU map/MSF catalog mismatches. 

ASVAL(FM=family,AM) 

It is recommended that the previous ASVAL run be made periodically to check whether any unexpected 
error conditions exist. As the installation becomes more familiar with MSS processing, the frequency of 
these periodic ASVAL runs can be decreased. 



Restrictions to ASVAL 

• Only one copy of ASVAL can be run at a time. 

• ASVAL, ASLABEL, and ASDEBUG cannot be run at the same time. 

ASUSE 

ASUSE reads data in the MSF catalogs and CSU maps and produces reports on the availability of space on 
MSF cartridges and the allocation of cubicle space within a CSU. The reports may not be completely up 
to date because the MSF catalogs and CSU maps can be updated while the reports are being generated. 

The types of reports that ASUSE generates are as follows: 

Report Description 

Basic usage report Lists general information about the use of each CSU in a subfamily. 

Optional report A Identifies cartridges with a specified number of streams available for 

assignments 

Optional report B Identifies cartridges with flags set in the MSF catalog. 

Optional report C Lists the contents of a CSU as described in the CSU map. 



t A cartridge that has the lost cartridge flag, inhibit allocation flag, or excessive write parity errors flag 
set is considered as having zero streams available for allocation regardless of the number of 
unallocated streams on the cartridge. 
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Report 



Description 



Optional report D 



Optional report E 



Lists detailed cartridge status information on each entry in the MSF 
catalog. 

Lists detailed cartridge and stream status information on each entry in 
the MSF catalog. 



The format of the ASUSE control statement is as follows: 

ASUSE,p 1 ,p 2 ,...,p n . 

Pi 
CS=id 



CS 

CS omitted 

FM=family 

FM 

FM omitted 

L=filenam 

L 

L=0 

L omitted 

OP=opt 



OP 

OP omitted 



Description 



CSU identifier of the CSU to be used. Up to 13 CSUs can be selected 
by the letters A through M. For example, CS=ACJG selects CSU A, C, 
G, and J. 

Same as CS=ABCDEFGHIJKLM. 

Same as CS=ABCDEFGHIJKLM. 

Family to be reported on. 

Same as FM=system default family. 

Same as FM=system default family. 

File on which listable output is to be written. 

Same as L=OUTPUT. 

No output file is to be generated. 

Same as L=OUTPUT. 

Type of report to be generated. 



op 



Description 



A Optional report A and basic usage report. 

B Optional report B and basic usage report. 

C Optional report C and basic usage report. 

D Optional report D and basic usage report. 

E Optional report E and basic usage report. 
Basic usage report only is to be generated. 
Same as OP. 



t Multiple options can be specified (for example, OP=AB). 
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Pi 
SB=sub 

SB 

SB omitted 

SL=n 

SL 

SL omitted 

SU=m 

SU 

SU omitted 



Description 

Subfamily to be reported on. Up to eight subfamilies can be selected by 
the numbers through 7. For example, SB=0273 selects subfamilies 0, 
2, 3, and 7. 

Same as SB=01234567. 

Same as SB=01234567. 

Minimum number of streams available for assignment; valid only with 
optional report A. Cartridges with n or more streams available are 
reported. 0<n<16, n<m (refer to SU=m). 

Same as SL=0. 

Same as SL=0. 

Maximum number of streams available for assignment; valid only with 
optional report A. Cartridges with m or less streams available are 
reported. 0<m<16, n<m (refer to SL=n). 

Same as SU=16. 

Same as SU=16. 



Basic Usage Report 

The basic usage report contains a title line, which identifies the subfamily, family, and CSU being 
reported on. The statistics in this report contain separate totals for CSUs and subfamilies. The 
following items are listed. 

• Number of CSU locations reserved for the subfamily. 

• Number of cartridges in the subfamily. 

• Number of cartridges with streams available for assignment. 

• Number of cartridges with 1 stream available for assignment. 



Number of cartridges with 16 streams available for assignment. 

Number of unassigned and unflagged streams. 

Number of assigned and unflagged streams. 

Number of flagged streams. 

Number of cartridges with the inhibit allocation flag set. 

Number of available off-cartridge links. 

Number of cartridges with available streams and no off-cartridge links. 
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The following output shows the format of a basic usage report. 



ASUSE REPORT FILE 

SUBFAMILY = 3 CSU = J FM = SYSTST 

BASIC REPORT 

COUNT OF CSU LOCATIONS RESERVED FOR SUB-FAMILY 
NUMBER OF CARTRIDGES IN THE SUB-FAMILY = 



NUMBER 


OF 


CARTRIDGES 


WITH 





STREAMS 


AVAILABLE 


NUMBER 


OF 


CARTRIDGES 


WITH 


1 


STREAMS 


AVAILABLE 


NUMBER 


OF 


CARTRIDGES 


WITH 


2 


STREAMS 


AVAILABLE 


NUMBER 


OF 


CARTRIDGES 


WITH 


3 


STREAMS 


AVAILABLE 


NUMBER 


OF 


CARTRIDGES 


WITH 


4 


STREAMS 


AVAILABLE 


NUMBER 


OF 


CARTRIDGES 


WITH 


5 


STREAMS 


AVAILABLE 


NUMBER 


OF 


CARTRIDGES 


WITH 


r 



STREAMS 


AVAILABLE 


NUMBER 


OF 


CARTRIDGES 


WITH 


7 


STREAMS 


AVAILABLE 


NUMBER 


OF 


CARTRIDGES 


WITH 


8 


STREAMS 


AVAILABLE 


NUMBER 


OF 


CARTRIDGES 


WITH 


9 


STREAMS 


AVAILABLE 


Ml 1 MD C D 
nunu i_ ix 


vyi 


/~ A r> to Trsrcc 
^«i\ i K i. uvjt- o 


LIT T LJ 

« i i n 


1 U 


STREAMS 


AVAI LABLE 


NUMBER 


OF 


CARTRIDGES 


WITH 


11 


STREAMS 


AVAILABLE 


NUMBER 


OF 


CARTRIDGES 


WITH 


12 


STREAMS 


AVAILABLE 


NUMBER 


OF 


CARTRIDGES 


WITH 


13 


STREAMS 


AVAILABLE 


NUMBER 


OF 


CARTRIDGES 


WITH 


14 


STREAMS 


AVAILABLE 


NUMBER 


OF 


CARTRIDGES 


WITH 


15 


STREAMS 


AVAILABLE 


NUMBER 


OF 


CARTRIDGES 


WITH 


16 


STREAMS 


AVAILABLE 



NUMBER OF FREE AND UNFLAGGED STREAMS = 

NUMBER OF ASSIGNED AND UNFLAGGED STREAMS = 

NUMBER OF FLAGGED STREAMS = 

NUMBER OF CARTRIDGES WITH INHIBIT FLAG SET = 

NUMBER OF AVAILABLE OFF-MSC LINKS = 

NUMBER OF CARTRIDGES WITH AVAILABLE STREAMS AND 

NO OFF CARTRIDGE LINKS = 



10 
h 



















64 


3 





Optional Reports A and B 

Optional reports A and B both contain a title line, which identifies the subfamily, family, and CSU being 
reported on, and list the following information about cartridges. Optional report A includes a cartridge 
only if the number of streams available for assignment is within the range specified by the SL and SU 
parameters. Optional report B includes only those cartridges for which flags are set in the MSF catalog. 

• Volume serial number of the cartridge. 

• X,Y coordinate pair of the cartridge location. 

• Number of streams available on the cartridge. 

• Number of off -cartridge links available on the cartridge. 



60455380 E 



3-33 



In addition to the preceding items, optional report B lists one or more of the following messages 
depending on the flags set in the MSF catalog. Refer to the definition of MSF catalog for more 
information about these flags. 

• EXCESSIVE PARITY ERRORS. 

• LOST. 

• INHIBIT SET. 

• STREAM n START OF FRAGMENT. 

• STREAM n FROZEN CHAIN. 

• STREAM n STREAM CONFLICT. 

The following output shows the format of optional report A. 
ASU5E REPORT FILE 

SUBFAMILY = 3 CSU = d FM = SYSTST 
OPTIONAL REPORT(S) AB 

VSN = V9900** 
X = *f5 

Y = 36 

AVAILABLE STREAMS = 

OFF CARTRIDGE LINKS = 

VSN = V99005 
X = ifit 

Y = 36 

AVAILABLE STREAMS = 

OFF CARTRIDGE LINKS = 

VSN = V99006 
X = «*3 

Y = 36 

AVAILABLE STREAMS = 

OFF CARTRIDGE LINKS = 

VSN = V99007 
X = H2 

Y = 36 

AVAILABLE STREAMS = 

OFF CARTRIDGE LINKS = 3 



END OF REPORT(S) AB 
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Optional Report C 

Optional report C contains a title line, which identifies the CSU being reported on. The CSU number and 
Y coordinate are printed at the top of the page. There is a new Y coordinate on each page, from Y=36 
through Y=0. X coordinates are written two to a line, from X=57 through X=0. The information listed in 
this report includes the following items. 

• X coordinate 

• Code 

• Vsn 

• Family 

• Subfamily 

• FCT link 

• Flags 



uptional Reports D and E 

Optional reports D and E both contain a title line, which identifies the subfamily, family, and CSU being 
reported on. Both reports list the following cartridge information about entries in the MSF catalog. 

• FCT ordinal of the MSF catalog entry. 

• X and Y coordinates of the location of the cartridge in the cubicle described by this entry. 

• Volume serial number of the cartridge in the cubicle described by this entry. 

In addition to the preceding information, optional report E lists the following information about the 
streams on the cartridges described above. 

• Off-cartridge links. Also referred to as Off-MSC (Mass Storage Cartridge) links. 

• Two words reserved for installation use. 

• Stream detail in octal. 

Refer to the definition of MSF catalog for more information about the catalog entries. 
The following output shows the format of optional report E. 
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ASUSE REPORT FILE 

OPTIONAL REPORT E MSFCATALOG FOR SUBFAMILY 3, CSU J FM = SYSTST 

ORD X Y VSN 

1 45 36 V99004 LINK1= 2 LINK2= 2 LINK3= 2 

S I TE=00 00 00 0000 00 00 000/00000000000000000000 



STREAM 














00-03 




20106 




20300 


22100 


24101 


04-07 




26102 




20300 


20007 


20010 


10-13 




20011 




20012 


20013 


20014 


14-17 




20015 




20200 


20300 


20300 


V99005 


LINK1= 


3 


LINK2= 


3 LINK3= 


3 




SITE: 


=00000000000000000000/00000000000000000000 


STREAM 














00-03 




20006 




20014 


20200 


22101 


04-07 




24102 




26103 


20007 


20010 


10-13 




20011 




20012 


20200 


20300 


14-17 




20015 




20016 


20200 


20300 



3 43 36 V99006 LINK1= 4 LINK2= 4 LINK3= 4 

S I TE=00000000000000000000/00000000000 000000000 



4 42 36 



STREAM 














00-03 




20106 




20011 


20013 


22001 


04-07 




24102 




26103 


20007 


20200 


10-13 




20300 




20200 


20300 


20014 


14-17 




20015 




20016 


20017 


20200 


V99007 


LINK1= 





LINK2= 


LINK3= 







SITE: 


=00000000000000000000/00000000000000000000 


STREAM 














00-03 




20106 




20014 


20016 


20200 


04-07 




20300 




20300 


20007 


20010 


10-13 




20011 




20012 


20200 


20300 


14-17 




20200 




20300 


20017 


20200 



ASDEBUG 

ASDEBUG allows the analyst to update appropriate entries in the CSU maps and/or MSF catalogs and 
thereby resolve inconsistencies reported by the ASVAL utility. ASDEBUG can also copy data from 
selected MSF files or cartridges to disk. This function of ASDEBUG is intended for use when errors such 
as unrecoverable read errors do not allow successful staging of an MSF file. 



NOTE 



ASDEBUG updates the CSUMAP for the specified 
CSU. (Refer to the definition of CSU map.) It is 
recommended that an installation make a copy of 
the CSU map on tape or on another device or 
family immediately after every update of the CSU 
map. 
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Input to ASDEBUG is via a directive file. Refer to the ASLABEL utility for a description of the format 
of directive statements. 

The format of the ASDEBUG control statement is as follows: 

ASDEBUG, Pl ,p 2 ,P3. 



-EL 
I=filenam 

I 

I omitted 

L=filenam 

L 

L=0 

L omitted 

■7 

Z omitted 
ASDEBUG Directives 



Description 

File on which directives are written. 

Same as I=COMPILE. 

Same as I=INPUT. 

File on which listable output is to be written. 

Same as L=OUTPUT. 

No output file is to be generated. 

Same as L=OUTPUT« 

Directives are contained on the ASDEBUG control statement. The I 
parameter is ignored. 

Directives are contained on the file specified by the I parameter. 



The following directives are available with ASDEBUG. The descriptions of the parameters for these 
directives follow this section. 

Read Streams 

OP=RS reads selected streams of a cartridge in a specified drawer (D=d) or identified by its vsn (V=vsn) 
or X,Y coordinates (XI, YI options). The CS parameter specifies the CSU where the cartridge resides. 
The range of streams to be read is specified by the SL and SU parameters. The streams are written to 
the file specified by the PF parameter. 

Read File 

OP=RF reads the file whose alternate storage address is specified by the CS, FO, and ST parameters. 
The file is written to the file specified by the PF parameter. 
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Release Frozen Chain Space 

OP=RP clears flags in the MSF catalog and releases MSF space for the chain whose alternate storage 
address is specified by the CS, FO, and ST parameters. 



Remove Cartridge Entry from MSF Catalog 

OP=RL removes an MSF catalog entry that is not linked properly to the CSU map. The CS and FO 
parameters identify the MSF catalog entry to be removed. 



Remove Cartridge Entry from CSU Map 



OP=RC removes a CSU map entry that does not have a corresponding FCT entry in the MSF catalog. The 
CS, XI, and YI parameters identify the CSU map entry to be removed. The cartridge at the particular 
X,Y location is put into the outut drawer and the CSU map entry is changed to unassigned. The CSU map 
should be backed up immediately after the ASDEBUG run to ensure consistency with cartridge labels and 
MSF catalogs (refer to the definition of CSU map). 



Parameters for the ASDEBUG Directives 

The descriptions of the parameters to the ASDEBUG directives follow. Not all options are valid with all 
directives, as indicated. 



Pi 
CS=id 

CS 

CS omitted 

D=d 

D 

D omitted 

FM=family 

FM 

FM omitted 

FO=ord 

FO omitted 
PF=filenam 



Description 

CSU identifier of the CSU to be used by ASDEBUG; id is a letter from 
A toM. 

Same as CS=A. 

Same as CS=A. 

Input drawer slot to be used; 0^d<7. Not valid if V=vsn or XI=n is 
specified. 

First available input drawer slot is to be used. 

V=vsn or XI=n and YI=m must be specified. 

Family to be processed. 

Same as FM=system default family. 

Same as FM=system default family. 

MSF catalog ordinal indicating the file to be read or the chain whose 
space is to be released. 

FO=ord must be specified for OP=RF, OP=RP, and OP=RL. 

File to which the MSF image (streams or file) is to be copied. Each 
stream copied is separated by an end of record. This file is defined 
under the user's current family and user index. 
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-EL 

PF 

PF omitted 

SB=sub 

SB 

SB omitted 

SL=i 

SL 

SL omitted 

ST=s 

ST omitted 

SU=j 

SU 

SU omitted 

V=vsn 

V omitted 
XI=x 

XI omitted 
YI=y 

YI omitted 



Description 

Same as PF=ZZZZBUG. 

Same as PF=ZZZZBUG. 

Subfamily to be used; 0<sub<7. 

Same as SB=0. 

Same as SB=0. 

Stream where OP=RS begins copying; 0<i^l5; i<j (refer to SU=j). 

Same as SL=0. 

Same as SL=0. 

Stream where OP=RF begins reading or OP=RP begins releasing. 

ST=s must be specified for OP=RF and OP=RP. 

Stream where OP=RS ends copying; 0<j<15; i<j (refer to SL=i). 

Same as SU=15. 

Same as SU=15. 

Volume serial number of the cartridge to be used; not valid if D=d, D, 
XI=x, or YI=y is specified. 

D=d or D, or XI=x and YI=y must be specified for OP=RS. 

X coordinate of the cubicle where the cartridge to be read resides; 
0<x<57 and x^30. YI=y must also be specified. D=d, D, or V=vsn must 
not be specified. 

D=d, D, or V=vsn must be specified. XI=x and YI=y must be specified 
for OP=RC. 

Y coordinate of the cubicle where the cartidge to be read resides; 
0^y<36 and y^l8. XI=x must also be specified. D=d, D, or V=vsn must 
not be specified. 

D=d, D, or V=vsn must be specified. XI=x and YI=y must be specified 
for OP=RC. 



Restrictions to ASDEBUG 

The following restrictions apply to the ASDEBUG utility. 

• MSSEXEC must be running when ASDEBUG is run. 

• Only one copy of ASDEBUG can be run at one time. 

• ASDEBUG, ASVAL, and ASLABEL cannot be run at the same time. 
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MSS OPERATIONAL PROCEDURES 

This section summarizes operational procedures used in an MSS environment. These include 
modifications to existing procedures and also new MSS procedures, especially in the areas of permanent 
file backup and reloading and disk space management. Refer to the descriptions of the appropriate 
utilities for details about these operational procedures. 



INITIALIZATION 

MSS processing is initiated when the ASDEF utility is run to create the system files necessary to allow 
storage of files on MSF. ASDEF creates both a CSU map for each CSU that is to store file data on 
cartridges and eight MSF catalogs (one for each subfamily) for each family that is to have MSF-resident 
files. Once these system files have been created, the ASLABEL utility can then be run to allocate 
portions of the CSU to each subfamily and to initialize cartridges for use by files belonging to these 
subfamilies. When permanent files are defined, they reside on disk until the ASMOVE utility is run. 
Depending on the parameters specified, ASMOVE can destage files to MSF and release the disk space 
assigned to files so that it is available for general use. 



DISK SPACE MANAGEMENT 

Installations must manage the availability of disk space more frequently in an MSS environment than in a 
non-MSS environment. This is necessary because MSF-resident files must be staged to disk before a user 
can access them, and their disk space is not immediately released upon completion of the jobs that 
attached the files. Consequently, disks are apt to approach a disk full condition unless the ASMOVE 
utility is used periodically to release disk space. 

The ASMOVE utility destages selected files to MSF and optionally releases their disk space. It is 
recommended that the installation use ASMOVE as part of a periodic disk space management procedure 
and also just prior to a full dump to reduce the amount of data dumped to tape. (Refer to Dump Tape 
Management.) 

The E display (refer to the E,M command in the NOS Operator's Guide) can be used to monitor the tracks 
on a device or set of devices as indicated by the TKS=nnn value for each disk. When too few tracks (as 
defined by the installation) are available on the direct access devices for a family or subfamily, the 
ASMOVE utility with the RD and RT parameters specified should be run. ASMOVE reads the PFC entries 
for the specified family, selects certain files to reside on MSF, and decides which files should be released 
from disk. 

Files can be destaged to MSF without their disk space being released. This destage-only feature can be 
used prior to a routine backup dump to create MSF images for files with the BR=MD attribute and 
thereby eliminate the need to include them on a backup dump tape. (Refer to Dump Tape Management.) 
Having an MSF image also provides backup for the file in special cases where the permanent file is being 
updated at the same time PFDUMP is being run. 

The destage-only feature can also be used to allow disk space to become available immediately when 
ASMOVE is run again. That is, ASMOVE can directly release disk space of files that have both disk and 
MSF images but are to reside on MSF only. However, for files that have no MSF image, there is a delay 
before the disk space can be released because these files must first be destaged to MSF. 
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MSF SPACE MANAGEMENT 

Installations must manage the availability of MSF space because MSF space is not automatically released 
when a permanent file is purged. This allows an installation to perform a permanent file recovery to a 
time prior to the purging of the file. On a typical dump tape, the entry for an MSF resident file includes 
the PFC and permit entries, but not the file data. A subsequent reload operation recovers only what was 
dumped - the PFC and permit information, but not the file data. Thus, MSF space for a purged 
permanent file cannot be released until the installation no longer needs to recover the file data, because 
the file data resides on MSF only and typically not on any dump tape. 

An MSF-resident file is stored only on the cartridges within the cubicles of CSUs assigned to a 
subfamily. When destaging a file to MSF, MSSEXEC selects the CSU with the most space available. If 
no CSU has enough free space to store the file being destaged, MSSEXEC abandons that destage request, 
issues a message to the dayfile, and continues to destage other files that fit on the available MSF space. 
To avoid this problem, installations should use the ASVAL utility periodically to release MSF space for 
purged files, thereby making it available for reuse. 

When an installation decides that it is time to reuse MSF space currently allocated to files that have 
been purged, it runs ASVAL with the RF and RL parameters specified. The RF parameter specifies an 
RDF, which is an auxiliary file produced by the permanent file utility PFDUMP and which contains 
versions of the MSF catalogs and PFC entries that were current at the time of the dump. ASVAL 
examines the RDF to identify unneeded MSF files (those without PFC entries) and their MSF space is 
released. The installation chooses which RDF to use based on the date and time of the dump that 
produced it. That is, a particular RDF is used only if there is no need for a permanent file recovery to a 
time prior to the dump that produced the RDF. 

Once an RDF is used by ASVAL to release MSF space, the installation should discard it and any other 
RDFs for the same set of devices. These RDFs cannot be used as input to ASVAL in any future run. The 
MSS software does not permit an RDF to be specified by the RF parameter on an ASVAL call, unless it 
was produced by PFDUMP after the last ASVAL run that released MSF space was completed. This 
prevents the inadvertent release of MSF space that was previously released and reassigned to a file. 



Example: 

Suppose two PFDUMPs were run a week apart producing two release data files, RDF1 and RDF2. 
Suppose, also, that according to both RDF1 and RDF2, file AFILE is an orphan (it has been purged but 
still resides on MSF). If the following call to ASVAL is made, the MSF space assigned to AFILE is 
released and made available for reuse, if no errors were encountered. 

ASVAL(RF=RDF1,RL) 

Now, suppose that a new file, BFILE, which did not exist when RDF1 and RDF2 were produced, is 
assigned to the MSF space on which AFILE has resided. If ASVAL were to accept either RDF1 or RDF2 
on a subsequent ASVAL call, the MSF space allocated to file AFILE (which is now the space where BFILE 
resides) is released. However, any RDF created after the ASVAL run that purged AFILE would not have 
an entry for AFILE and, hence, ASVAL would not inadvertently release the MSF space presently 
allocated to BFILE. 

After ASVAL uses a release data file to release MSF space, the corresponding backup tape from 
PFDUMP is the oldest tape that should be used for the first reel of a future incremental load. The first 
reel determines which files are to be reloaded according to the CIR on the tape (refer to PFLOAD in 
section 1). Use of an older tape as the first reel can allow the PFC entry for a purged file to be restored 
even though its MSF space may have been reassigned. The MSS software does not prevent loading from 
the wrong dump tape, but does detect as an error an attempt to stage a file whose data was overwritten. 
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Example: 

Suppose that RDF1 and RDF2 are as in the previous example, and that file CFILE is an orphan according 
to RDF2, but not according to RDF1. The following ASVAL call releases MSF space allocated to CFILE. 

ASVAL,RF=RDF2,RL. 

Now suppose that the dump tape created by the PFDUMP run that produced RDF1 is used as the first 
reel of an incremental PFLOAD. Then the PFC and permit entries for file CFILE are reloaded, but, in 
fact, file CFILE does not exist on MSF. This will be detected as an error when a user attempts to attach 
CFILE. 



BACKUP AND RECOVERY 

Permanent file backup and recovery methods in an MSS environment are similar to those in a non-MSS 
environment. It is assumed that most installations with disk resident permanent files have a file backup 
procedure consisting of a full dump followed by a series of incremental dumps. The assumed reload 
procedure is to load from tapes starting with the most recent incremental dump tape and continuing 
through older incremental dump tapes until the most recent full dump tape is processed. These 
procedures can be modified as follows to accommodate MSF resident files. 



File Dumping 

The normal backup dump procedure is to dump files based on the modification date field in the PFC 
entries for the files. New parameters to PFDUMP provide the capability to dump files that have been 
modified during a certain interval, which is useful in recycling old dump tapes (refer to Dump Tape 
Management later in this section). For files that reside only on MSF, the option to stage the file to disk 
and thereby include it in the dump or to suppress staging and include only the file's PFC and permit 
information on the dump tape is provided. If the device or family being dumped has MSF-resident files, 
the following procedures should be included with the normal dumping procedures. 

Full Dumps 

Full dumps should be performed as usual, but OP=S should be specified on the call to PFDUMP to 
suppress staging. Thus, all files on disk are dumped but only the PFC and permit entries for MSF files 
without disk images are included in the dump. It is unnecessary and not feasible to dump the files that 
reside only on MSF. OP=S and SD should be specified on the call to PFDUMP; RD=filenam should be used 
at the discretion of the installation. 

OP=S Selects no staging. If the SD option was inadvertently used on any 

previous nonincremental dump, an incremental dump should be 
taken prior to the full dump. 

SD Updates the dump date/time field on each master device dumped to 

permit files created or modified prior to this dump to be released 
when ASMOVE is run again. Refer to Release Algorithm in 
ASMOVE description. 

RD=filenam Specifies that PFDUMP is to write a release data file to be used 

later by ASVAL. RD=filenam is included or excluded on a call to 
PFDUMP depending on how often the installation wants to purge 
unneeded MSF files. 
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Incremental Dumps 

Incremental dumps should be performed as usual. No staging should occur because any files that were 
created or modified since the last dump will still be on disk if a tape backup is required. The following 
parameters should be specified on the call to PFDUMP. 

OP=M Selects incremental dumps. 

SD Updates the date/time field on each master device dumped, as 

described above for full dumps. 

AD=yymmdd and AT=hhmmss Selects the date and time just prior to the previous incremental or 

full dump of the device. Hence, all files not included in the last 
dump are dumped. 

The following parameters should be used at the discretion of the installation. 

OP=S Selects no staging. If the SD option was inadvertently used on any 

recent partial dump, OP=S should not be specified so any file with a 
BR=Y attribute which had its disk space inadvertently released will 
be included in the dump. 

RD=filenam Specifies that PFDUMP is to write a release data file to be used 

later by ASVAL, as described above for full dumps. 

Dump Tape Management 

In a non-MSS environment, it is possible to make all previous dump tapes available for use after a full 
dump is completed. However, in an MSS environment, such dump tape recycling cannot occur because 
files that have resided only on MSF for some time are probably not included on any recent dump tape. 
When a low percentage of files on a tape are active files, it is possible to redump any remaining files in 
order to recycle the tape by running PFDUMP with OP=M, BD, and BT parameters, but not OP=S, 
specified.! This performs a dump of all files that were last dumped before the date and time specified 
on the PFDUMP call. If necessary, files will be staged in from MSF; after the dump is completed, the 
disk space for these staged files is released. Thus, files that might not be on any dump tape made after 
the date specified by the BD parameter are dumped and tapes created before this date can be recycled. 

The installation can reduce the number of dump tapes it creates by using ASMOVE to reduce the amount 
of data written on these dump tapes. If ASMOVE is run prior to an incremental dump, files with the 
BR=MD attribute can be destaged to MSF and excluded from the dump. That is, the incremental dump 
will exclude the files with a BR=MD attribute that are on both MSF and disk. If ASMOVE is run prior to 
a full dump, disk space for files that do not have to be on disk can be released and these files are not 
written on the dump tape. The following procedures involving dumps and ASMOVE runs can be used for 
efficiency. 

1. Run ASMOVE to destage files with the BR=MD attribute. 

2. Take an incremental dump to back up files with the BR=Y attribute. 

3. Run ASMOVE to release the disk images of files backed up in step 2. 

4. Take a full dump to reduce the number of dump tapes involved if a reload is required. 



t It is possible to specify the AD and AT parameters also, thereby dumping files that were dumped 
during an interval - after the date and time specified by AD and AT and before the date and time 
specified by BD and BT (refer to parameters for PFDUMP). This performs a dump of all files last 
dumped during the interval specified (including MSF-resident files) and allows the site to recycle all 
dump tapes created during this interval. 
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CSU Map/MSF Catalog Backup 

A CSU map is created for each CSU in an MSS environment and is updated by the ASLABEL, ASVAL, and 
ASDEBUG utilities. (Refer to the definition of CSU map.) It is recommended that an installation make a 
copy of the CSU map on tape or on another device or family immediately after every update of the CSU 
map. If the device containing subfamily of the default family is reloaded, the latest CSU maps should 
be recovered from the backup copies. After recovering the CSU maps, the installation should run the 
ASVAL utility with the AM and FM parameters specified to ensure that the CSU map and MSF catalog 
entries match. If they do not, corrective action should be taken as described in Error Conditions and 
Corrective Action. Failure to retain or recover the latest CSU maps can cause problems with future 
ASLABEL runs (refer to the definition of CSU map). 

An MSF catalog is created for each subfamily of a family that can have MSF resident files and is updated 
by the ASLABEL, ASMOVE, ASVAL, and ASDEBUG utilities. When PFDUMP copies permanent files to 
tape for a master device or all devices in a family, it ensures that corresponding MSF catalogs are also 
dumped. (If MSSEXEC has an MSF catalog attached in modify mode, PFDUMP interfaces with MSSEXEC 
so that the MSF catalog is included on the dump tape.) Consequently, if PFLOAD is used to reload all 
files, the MSF catalogs are automatically recovered and entries for all MSF resident files reflected in 
recovered PFC entries will exist in the recovered MSF catalog. 

If PFLOAD is run after the ASLABEL utility has updated the MSF catalog and CSU map but before the 
MSF catalog has been backed up, the recovered MSF catalog will not match exactly the corresponding 
CSU map. In this case, recovery procedures (as described in CSU Map/MSF Catalog Mismatch later in 
this section) must be taken to bring the CSU map, MSF catalog, and cartridge label information into 
agreement. 



File Reloading 

PFLOAD runs should be made as usual. PFLOAD reads the CIR records from the most recent 
incremental dump tape to control loading of file data and PFC and permit information. For MSF resident 
only files, PFLOAD only reloads the PFC and permit information (if PFDUMP clumped only this 
information). The following situations involve PFLOAD in an MSS environment. 



• 



If one device needs to be reloaded, the DN or TD parameter specifies the device. The OP=Z and 
UD options should not be specified. 



• If PFLOAD is used for other than a device recovery, both OP=Z and UD should be specified. 
The OP=Z option ensures that the PFC entry does not link to an MSF file that may no longer 
exist, and UD ensures that the file is included in the next incremental or full dump. 

• If a file has a nonzero asa value in its PFC entry (indicating that the file has an MSF image), the 
ASCVER flag in the PFC entry will be set when the PFC and permit information are reloaded. 
If the file is successfully staged to disk when it is attached, this flag is cleared. Otherwise, the 
flag remains set. This can be used to indicate the possibility of an operational error, such as 
omitting OP=Z when a file or set of files is reloaded from an obsolete dump tape. 



• 



If any unscheduled device reload that includes recovery of an MSF catalog and/or CSU map is 
made, ASVAL should be run with the AM and FM parameters specified. ASVAL examines the 
PFC entries for MSF resident files, the MSF catalog, and the CSU map to detect any error 
conditions that exist. 
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ERROR CONDITIONS AND CORRECTIVE ACTIONS 

It is possible for operational, hardware, or software malfunctions to cause a variety of error conditions to 
exist or appear to exist in the MSF catalogs, CSU maps, PFC entries, or cartridge labels. The ASVAL 
utility can analyze the MSF catalogs, CSU maps, and PFC entries to detect these errors, and the 
ASLABEL utility can identify problems with cartridge labels. The following sections describe some 
specific error conditions and the actions that should be taken to correct them. Most of the errors are 
caused either by incorrect operational procedures that result in the recovery of the wrong version of an 
MSS system file, or by abnormal termination of MSSEXEC or MSS utility processing, which can interrupt 
the updating of an MSS system file. 



Permanent File Recovery 

If a permanent file cannot be accessed or is included by ASVAL on the validation report, the following 
methods can be tried to recover a copy of the file. 

1. Attach the file. If the file has a disk image or can be staged in from MSF, the file data will be 
available on disk and can be copied to another file. ASVAL should then be run as described in 
step 2. 

2. If the file cannot be attached, reload the file from a dump tape. To identify the PFDUMP run 
which saved a backup copy of the file, check the output from ASVAL or PFCAT, which includes 
date and time fields from the PFC entry for the file. Depending on the BR attribute (backup 
requirement) of the file, a backup copy on a dump tape may not exist. 

If the file can be reloaded to disk, ASVAL should be run as follows: 

ASVAL,FM=family,SB=sub,FX=n,AM. 

where family and sub identify the family and subfamily of the recovered file and n is 
sufficiently large that the fixing/flagging will be done. ASVAL sets the obsolete flag in the 
PFC entry because the file now has a disk image; thus the file is disassociated from the error 
condition. The error condition may still exist in the MSF catalog or CSU map, but it can be 
investigated and corrected by the installation via the ASDEBUG utility. Before using ASDEBUG 
to correct the error, the installation should take an incremental dump so the old PFC entry with 
an asa value pointing to a problem MSF-resident file will not be reloaded if a device reload 
occurs before the next scheduled backup dump. 

3. If steps 1 and 2 fail, try to regenerate the file. Depending on the particular problem and status 
of the cartridges to which the file was destaged, the OP=RF or OP=RS directive to ASDEBUG 
might recover the file data. 

4. If the file cannot be recovered, purge it so there is no PFC entry pointing to a problem 
MSF-resident file. 
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Cartridge Restoration and Reuse 

If a cartridge is unexpectedly found anywhere outside its assigned cubicle, the following steps can be 
taken to restore the cartridge so it can be used again. 

1. Put the cartridge in the input drawer of the CSU to which it is assumed to belong and run 
ASLABEL with the OP=RS directive. If the cartridge label information agrees with the CSU 
map entry for the cubicle with the X,Y coordinates written on the cartridge label, the cartridge 
will be restored to that cubicle and the MSF catalog entry for the cartridge is updated to clear 
the lost flag. Otherwise, the cartridge is put in the output drawer and the cartridge label 
information is included in the output from ASLABEL. 

2. If the cartridge was not restored to its CSU cubicle, examine the label information reported by 
ASLABEL. If the cartridge is assigned to a different CSU, repeat step 1 using the correct CSU. 
If the family name is blank, the cartridge has a scratch label and can be assigned normally with 
the OP=AM directive to ASLABEL. 

3. If steps 1 and 2 fail, examine the CSU map entry for the cubicle with the X,Y coordinates 
written on the cartridge label to see how the cubicle is assigned. Examine the cartridge, if any, 
in this cubicle. Also, it might be useful to run ASVAL to ensure the CSU map and MSF catalog 
entries for the cartridge match or to identify affected permanent files, if any, if they do not 
match. 

4. If set 3 does not produce any useful information and the cartridge cannot be restored, use the 
OP=FX directive to ASLABEL to rewrite the cartridge label and thereby make a scratch 
cartridge. It might be useful to first run ASDEBUG with the OP=RS directive to preserve the 
data on the cartridge. 



Removal of Faulty or Missing Cartridges 

The following steps should be taken to remove a cartridge which has unrecoverable errors, or to release 
the CSU map entry for a cartridge which is missing. 

For unallocated cartridges: 

1. Attempt to remove the cartridge with the ASLABEL OP=RM directive. 

2. If CARTRIDGE NOT FOUND is reported, repeat step 1 specifying the LT parameter. 

3. If CARTRIDGE NOT EMPTY is reported, at least one AU on the cartridge is still allocated. 
For allocated cartridges: 

1. Use the ASLABEL OP=IB directive to inhibit further allocation of the cartridge. 

2. Run ASVAL specifying the AM parameter. Examine the report for possible discrepancies 
between the CSU map, MSF catalog, and PFC entries related to this cartridge. 

3. If no MSF catalog entry corresponds to the CSU map entry, use the OP=RC directive to 
ASDEBUG to remove the map entry. 

4. If no discrepancy is reported by ASVAL, the affected files should be attached in write mode (if 
possible), reloaded using PFLOAD with the OP=Z option, or purged. Then ASVAL release 
processing should be done to release the MSF space on the cartridge, and the cartridge can be 
removed as in step 1. 
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MSF Catalog/CSU Map/PFC Problems 

If error conditions exist in the MSF catalogs or CSU maps, the recovery procedure is to correct the 
appropriate entry rather than reload the entire file. Reloading other than the latest copy of the CSU 
map is not feasible because it can contain entries for several families and these entries would not be up 
to date. Reloading an old copy of the MSF catalog is not desirable because any permanent file that was 
destaged and released from disk since the last incremental dump will be lost. The following sections 
describe corrective action for specific problems with MSF catalogs, CSU maps, or PFC entries. 



MSF Catalog/CSU Map Mismatch 

The following examples of MSF catalog/CSU map mismatches can appear as error type 1 or 2 on the 
ASVAL output report, which identifies the mismatch and the permanent files or orphans affected. 
Before taking any corrective action, the analyst should ensure that operational errors did not result in 
loading the wrong version of the CSU map or MSF catalog. 

• If a cartridge has an MSF catalog entry indicating that all AUs on the cartridge are available 
for allocation but is not identified in any CSU map entry (type 1 mismatch), use the OP=RL 
directive to ASDEBUG to remove the MSF catalog entry for the cartridge. 

• If a cartridge is identified in a CSU map entry but has no MSF catalog entry (type 2 mismatch), 
use the OP=RC directive to ASDEBUG to update the CSU map entry to unassigned and empty 
status. This directive will write a scratch label for the cartridge, if any, and place the 
cartridge in the output drawer. 

• If a cartridge has an MSF catalog entry indicating that at least one AU on the cartridge is 
allocated, recover the disk space for the affected permanent file, if any, or purge the file. Run 
ASVAL to purge unneeded MSF files and thereby make the cartridge unallocated. Use the 
OP=RL directive to ASDEBUG to remove the MSF catalog entry for the cartridge. 



NOTE 



It sometimes takes two ASVAL/ASDEBUG runs to 
clear up completely type 1 or type 2 errors. 
Therefore, it is recommended that ASVAL be 
rerun with the AM parameter after an ASDEBUG 
run using OP=RC or OP=RL. 
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MSF Catalog Chain Problems 

AUs that are allocated to an MSF resident file are chained together in the MSF catalog to identify the 
sequence of AUs that contain the file. (Refer to the definition of cartridge.) For most files, the AUs in 
the chain reside on the same cartridge. Hence, one disk access is sufficient to update information for 
the entire chain at one time. However, an MSF resident file can reside on several cartridges and several 
disk accesses may be necessary to update its chain. If MSSEXEC is interrupted during such an update, 
the resultant chain will be incomplete. ASVAL identifies incomplete chains as error type 4, 5, or 6 on 
the validation report. The following are types of incomplete chains. 

• If an incomplete chain is produced while an MSF resident file is being purged, it is a chain 
fragment (one without an HOC entry). 

• If an incomplete chain is produced while a file is being destaged to MSF, it is an ill-formed 
chain (one without an EOC entry). 

• If an ill-formed chain is not corrected, the AU that should have been linked to it may be reused 
and become part of a good chain. Although the ill-formed chain may appear to be complete, the 
ill-formed chain and the good chain are intersecting. 

The corrective action for any of these bad chain conditions is as follows: 

1. Run ASVAL with the FM parameter specified and use a sufficiently large FX=n value so that 
ASVAL updates the MSF catalog entries affected by the problem chains. 

2. Recover the permanent files, if any, that have MSF images potentially affected by these error 
conditions. (The ASVAL report identifies these files.) The procedure described in Permanent 
File Recovery should be used. 

3. Take an incremental or full backup dump. This prevents PFC entries with inaccurate asa values 
or problem MSF chains from being recovered if a device reload is necessary. 

4. Run ASDEBUG with the OP=RP directive to make each AU on the problem chain available for 
allocation. Thus, the AUs can be included in a new chain without any problems. In the case of 
intersecting chains, all chains that have an AU in common with another chain should be released 
before any further destage attempts; otherwise, errors will occur when a user tries to attach a 
file that is contained on an intersecting chain. 

PFC/MSF Catalog Mismatch 

It is possible that an old version of an MSF catalog can be reloaded because of incorrect operational 
procedures. If so, the asa value in the PFC entry for a file can be invalid according to the obsolete MSF 
catalog or can point to a problem chain. If the correct version of the MSF catalog is available on tape, it 
should be reloaded. If it is not available, the following action is appropriate. If the file also has a disk 
image, ASVAL should be run to clear the asa field in the PFC entry. If there is no disk image, the 
analyst should reload the file from tape, if possible, and then run ASVAL to clear the asa value. 
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PSEUDO RELEASE 

The pseudo release capability allows an installation to experiment with MSS operational procedures in 
order to determine which procedures should be used normally and to become adept at recognizing error 
conditions and performing appropriate recovery procedures. While employing the pseudo release feature, 
the installation runs no risk of losing any permanent files used in this checkout phase, as explained in the 
following paragraphs. 

Pseudo release mode is initiated by an ASMOVE run with TM=Y specified. ASMOVE selects files to be 
destaged and/or released from disk by using the destage and release algorithms as usual. The destage to 
MSF process is the same whether or not pseudo release mode is in effect (refer to the description of 
ASMOVE for details on destaging). However, the procedures for disk space release vary depending on 
whether or not pseudo release mode is enabled. Disk space is not actually released in pseudo release 
mode. Rather, the AFPDR flag (refer to the definition of catalog entry in section 1) is set in the PFC 
entry for a file that has been selected for disk space release. This flag indicates that PFM should ignore 
the disk image for this file. Therefore, if the user attaches such a file, the disk image is ignored and the 
file is staged to disk from MSF. The normal staging process is followed except that the disk image is 
created on a scratch device instead of a permanent file device. Thus, in actuality, two disk images of 
the file exist. However, once the file is staged to disk, whether or not staging errors are detected and 
reported by MSSEXEC, the AFPDR flag is cleared so that the user accesses the original disk image. 
Also, the file staged to the scratch disk is released so the scratch space is available for reuse. If MSS 
processing becomes disabled, the original disk image can still be accessed via an ATTACH request. 

There are two methods for terminating pseudo release mode. One is to perform a full dump followed by 
a reload with OP=Z specified on the P FLO AD call. This clears the asa field in the PFC entry for each 
file, thereby indicating that no MSF images exist and that the files reside on disk only. The other method 
is to run ASMOVE with TM=N specified. This causes the disk images for pseudo-released files to be 
really released from disk, thereby leaving the file with only the MSF image. 



Error Recovery Examples 

The following examples can be used after pseudo release mode is enabled to force different error 
conditions to occur. The installation can implement these incorrect operational procedures and then 
perform error recovery action without endangering any of the permanent files involved. These examples 
assume that ASDEF has been run to create a CSU map and the MSF catalogs for the CSU and family 
being tested. 



Example 1: 

1. Run ASLABEL to add cartridges (for example, A, B, C) to a subfamily. 

2. Dump the CSU map file to tape. 

3. Run ASLABEL to remove cartridge A and add another cartridge (for example, D). 

4. Reload the CSU map file dumped in step 2. This creates a mismatch between the CSU map and 
MSF catalog, because the MSF catalog indicates that cartridge D resides in the CSU but 
cartridge A does not. 

5. Run ASVAL to detect the mismatch. 

6. Run ASDEBUG to correct the mismatch. The resultant CSU map and MSF catalog should 
contain entries for cartridges B and C, but not A or D. 
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Example 2: 

1. Run ASLABEL to add several cartridges to a subfamily. 

2. Create some permanent files with different backup requirements and preferred residence 
requirements. 

3. Run ASMOVE to destage and/or release the files created in step 2. 

4. Physically remove one of the cartridges from the CSU; do not use ASLABEL to remove it. 

5. Attach the files whose disk space was released in step 3. 

6. Run ASVAL to verify that only files resident on the removed cartridge are affected. 

7. Run ASLABEL to restore the cartridge removed in step 4. 

8. Attach the files reported in step 6. There should be no problems reported. 

Example 3: 

1. Run ASLABEL to add several cartridges to a subfamily. Make a backup copy of the CSU map 
and MSF catalog files. 

2. Create several files with the BR=Y or BR=MD attribute. Run ASMOVE to destage all of them 
and release those with the BR=MD requirement. 

3. Take a backup dump of the family. 

4. Reload the CSU map and MSF catalog backed up in step 1. 

5. Create several new files with the BR=MD attribute. Run ASMOVE to destage them and to 
release the disk space of the files with the BR=Y attribute in step 2. 

6. Attach the files created in step 2. They should have been overwritten by the files destaged in 
step 5. 

7. Recover the files with the BR=Y attribute from the dump tape made in step 3. 

Example 4: 

Try to interrupt MSSEXEC while it is destaging new files or releasing unused MSF files to create 
incomplete chains. ASVAL reports such errors and ASDEBUG fixes them. 
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NETWORK UTILITIES 



This section describes the following utilities and files involved in the operation of the network and 
time-sharing subsystems of NOS. 

• Load File Generator (LFG). This utility produces a direct access file used by the Network 
Access Method (NAM) to perforin the downline load of network processing units (NPUs or 
255x's). 



• 



NPU Dump Analyzer (NDA). This utility produces readable listings from dump files produced 
when NAM dumps network processing units. 

• Application Interface Program (AIP) Trace. This utility produces a trace file of the messages 
transferred between IAF and NAM. The information contained in this trace can be useful in 
tracking network problems and in debugging application programs. 

• Network description files and VALNET. Network description files are used by the Transaction 
Facility (TAF) and the Time-Sharing Module. They describe the physical time-sharing network 
via terminal definition directives prepared by the site analyst. VALNET verifies the correct 
construction and syntax of the directives on the network description files before using them in 
an operating environment. 

• Stimulators. A stimulator is a collection of programs that artificially load the system to 
analyze the effects of such a load on system performance and reliability. 

LOAD FILE GENERATOR (LFG) 

The Load File Generator (LFG) is a utility program that reformats Communications Control Program 
(CCP) files for subsequent use by the Network Supervisor of NAM to load network processing units 
(NPUs). LFG accepts one or more input files in single or multifile format and produces a single output 
file for use by the Network Supervisor. 



FILE DESCRIPTION STATEMENTS 

File description statements describe the structure of the input files and allow the analyst to assign names 
to the various memory modules contained on the input files. 

The file description statement format is as follows: 

filenam 



(":mres 1 ,n] r~:mres m ,n~| 
[» ovl l» n J "" |j ovl m> n J 



filenam Name of local file containing NPU memory modules. This file is created by the 

CCP installation process. 

mres A three-character (alphanumeric) name of macromemory resident or 

mieromemory. These names must agree with the names assigned to P2LID and 
PI LID parameters specified on the NPU statement(s) used in creating the 
network configuration file. (Refer to the Network Definition Language 
Reference Manual for further information.) 
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ovl A three-character (alphanumeric) name of overlay. The first character of the 

name must be a letter from A through O. This parameter is required when 
overlay modules are present on the input file. Each overlay module must have a 
unique ovl. 

n Number of records preceding the memory module header record in the file. The 

starting record position is dependent upon the procedure used to create the 
input file. The n parameter can range from to 9; n is usually for memory 
resident records and 2 for overlay records. 

Each :mres,n or ;ovl,n parameter pair corresponds to a memory resident or overlay load module on the 
input file being described. The order of these parameter pairs must match the order of the load modules 
on file filenam. A colon must precede the name of a memory resident module, and a semicolon must 
precede the name of an overlay module. A period must terminate each file description statement. 
Embedded or leading blanks are not allowed. If more than 80 columns are needed to describe an input 
file, the file description statement can be continued to as many lines or cards as necessary. 

The analyst must determine the order of load modules on the CCP input files. If the same load module is 
present on more than one input file, it should be described on only one file description statement. 
Appropriate file positioning control statements should precede the LFG control statement to position 
input files to skip duplicate load modules on all but one input file. (LFG does not rewind input files 
before processing them.) Refer to the CDC CYBER Cross System Link Editor and Library Maintenance 
Programs Reference Manual for information on input file generation. 



FILE DESCRIPTION STATEMENT EXAMPLES 

In each of the following examples, the file description statements are appropriate for the indicated input 
file configuration. 

• Three files, each containing one memory resident module. 

TAPE1:MAA,0. 
TAPE2:MAB,0. 
TAPE3:MAC,0. 

• One file with two memory resident modules and two overlay modules: 

TAPE1:MAC,0:MIC,0;DLO,2;OV1,2. 

• Two files, the first containing a single memory resident module and the second containing four 
overlay modules with two extra records each. 

TAPE:MAA,0. 
TAPE2;OVl,2;OV2,2;OV3,2;OV4,2. 



4-2 



60455380 A 



REQUIRED NAMES FOR LOAD MODULES 

The Network Supervisor of NAM expects the following load modules to be named as specified. 
Load Module Required Name 

Dump/load overlay DLO 

Memory resident 2550 bootstrap program DBO 

EXECUTION 

LFG is invoked with the following control statement without parameters. 

LFG. 

File description statements are read from the file INPUT, and error messages are written to the file 
OUTPUT. The CCP files named on the file description statements must be local to the job at the time 
LFG is executed. 

LFG produces a single load file for use by the Network Supervisor of NAM. The local file name of this 
file is NPUFL. The Network Supervisor expects this file to be a public direct access permanent file 
named CCPFILE and stored under the system user index (377777). The analyst must provide appropriate 
control statements to create the permanent file CCPFILE and store it under the system user index. The 
MOVEPF utility (refer to the NOS Installation Handbook) may be useful in storing the load file under the 
system user index. 

EXECUTION EXAMPLE 

In the following example, a load file is created for two NPUs. The CCP files were created earlier and 
stored under the user name ANLYST as direct access permanent files with names and contents as follows: 

Permanent File Name Contents 



REMOTE File 1: 2550 micromemory 

File 2: 2550 macromemory 

LOCAL File 1: 2550 macromemory 

MICDBO File 1: 2550 micromemory 

File 2: 2550 bootstrap program 

DIAG File 1: Diagnostic overlay 

DMPLD File 1: Dump/load overlay 

In this example, two extra records precede the two overlay modules. No extra record is present for any 
memory resident modules. The 2550 micromemory module is present on two files (REMOTE and 
MICDBO). Either copy may be used but not both; the unused copy must be skipped before invoking LFG. 
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The following job creates the desired load file. 
NPULOAD. Job statement. 



USER(ANLYST,PASS) 



ANLYST's password is PASS. ANLYST does not require a CHARGE 
statement. (Refer to MODVAL description, section 5.) 



ATTACH(LOCAL,REMOTE) | 

ATTACH(MICDBO,DIAG) [ CCP files are attached. 
ATTACH(DMPLD) j 

SKIPF(MICDBO) Duplicate 2550 micromemory module is skipped. 

DEFINE(NPUFL=CCPFILE) Permanent file CCPFILE is defined with local file name of NPUFL. 

LFG. Load file is generated. 

7/8/9 End-of-record. 



REMOTE:MIC,0:REM,0. 

LOCAL:LOC,0. 

MICDB0:DB0,0. 

DIAG;DIG,2. 

DMPLD;DLO,2. 

6/7/8/9 



File description statements. 



End-of-information. 



Upon successful completion of this job, the analyst should execute MOVEPF to move CCPFILE to the 
system user index. The analyst also has the option of running the LFG job under DIS at the system 
console. In this case, the file description statements would be placed on file INPUT via the 026 file 
editor, and the job statement would be omitted. Also, if the analyst inserts the control statement 
SUI(377777) immediately before the DEFINE statement when running this job at the system console, 
running MOVEPF is unnecessary. (Refer to the NOS Operator's Guide for information on DIS and the 
NOS Systems Programmer's Instant for information on the 026 file editor.) 

The following Network Definition Language statements are appropriate when creating a network 
configuration file for use in a network configured with NPUs and load modules described in this example. 

REM1: NPU P1LID=MIC,P2LID=REM,NPUTYPE=2550,NODE=10. 

LOCI: NPU P1LID=MIC,P2LID=LOC,NPUTYPE=2550,NODE=12. 

Other NPU names, node numbers, and/or additional parameters can be specified as necessary (refer to 
the Network Definition Language Reference Manual). 
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NPU DUMP ANALYZER 

The NPU Dump Analyzer (NDA) is a utility program that produces readable printout from the NPU dump 
files; the NPU dump files are created by the Network Supervisor during the initiation or reloading of a 
failed NPU. NDA reports determine the state of a network processing unit at the time a dump was 
generated. 

NDA must be a system origin job and is accessed by a control statement that allows selection of the 
following. 

Specific NPU dumps by NPU name or dump number. 

Dumps from/to specific NPU macromemory addresses. 

Retention of dump file after processing. 

Release of dump file without producing a listing. 

Listing options. 



CONTROL STATEMENT 

The format of the control statement is 

NDACp^pg,...,^) 

where pj is a keyword or a keyword equated to a value. All keywords are order-independent. If the same 
keyword is specified more than once, the last (rightmost) occurrence of the keyword overrides all 
previous ones. An invalid parameter name or value causes an error message to appear. NDA ignores an 
invalid DN, NPU, or AD parameter value and continues processing. An invalid parameter name or an 
invalid value for B, E, or LO causes termination of the run. 

Pi Description 

AD=yymmdd Last access date in the form of year, month, day. Dump files that have not 

been accessed on or after the date specified are purged. Default is not to purge 
files based on a date. However, files can be purged for other reasons (for 
example, failure to use the NR option). 

B=addr One- to six-digit hexadecimal address within the NPU macromemory at which 

the dump report begins. Default is B=address of the actual beginning of the 
dump. 

DN=n Decimal dump number assigned by the Network Supervisor of NAM at the time 

the dump is generated; 1 < n < 540. Up to five different dumps to be analyzed 
can be selected by repeated use of DN=n specifications, separated by commas. 
Default is that NPU must be specified on the control statement.! 

E=addr One- to six-digit hexadecimal address within the NPU macromemory at which 

the dump report ends. Default is E=address of the actual end of the dump. 



t Either DN or NPU (but not both) must be specified. Unpredictable results can occur if both DN and 
NPU are specified. 



60455380 G 4-5 



Pi Description 



LO=opt One or two characters, each of which specifies a portion of the dump to be 

listed; any unspecified portions are not listed. 

opt Description 



M Macro memory 

R Registers 

If LO=0 or LO alone is specified, the entire listing is suppressed. This is used to 
purge dump files when no listing is desired. Default is LO=RM. 

NPU=npu One- to seven-character name assigned to a specific NPU in the network 

configuration file, specifying that all dumps for the given NPU are selected. 
Default is that DN must be specified on the control statement, t 

NR Specifies that the dump file is not to be released after NDA completes 

processing and hence can undergo additional processing. 



1 NOTE | 

If NR is omitted, NDA purges the dump file after 
NDA completes processing. 



REPORT FORMATS 



Each complete dump file report contains three records for each dump file analyzed. The first record is 
shown in figure 4-1. 



NPU DUMP = 006 NDA(DN=6,E=70,NR) 



TIME 13.16.03 
DATE 78/03/21 
NPU NAME NODE 3 

Figure 4-1. First Dump Record Format and Sample 



t Either DN or NPU (but not both) must be specified. Unpredictable results can occur if both DN and 
NPU are specified. 
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The second dump record is formatted into separately addressed lines of 16 NPU or MUX file registers 
each. The content of each register is given in hexadecimal form, and each group of registers appears 
separately. 

The third dump record is formatted into separately addressed lines of 16 NPU or MUX macromemory 
words each. This is the equivalent of 32 ASCII characters. The content of each word is given in 
hexadecimal form. If the content of the words in a line duplicates that of the previous line, the duplicate 
line is not printed; addressing continues with the next nonduplicate line, which is flagged with two 
asterisks (**) by its first word to indicate the omission. 



NETWORK DUMP FILES 

The network dump files, created by the Network Supervisor during network operation, are allocated in 
the form of a permanent file for each NPU dump taken. These dump files are then indexed in a separate 
directory file, NDA4IND. This file contains indicators that show the presence or absence of individual 
dump files, as well as other information about individual dump files. Individual dump files are named 
DMPAnnn, where nnn is a unique dump number in the range 001 to 540. The dump number is specified by 
the DN option on the NDA control statement. 

The Network Supervisor allocates dump files and makes directory file entries for each. NDA processes 
and releases the dump files and removes corresponding directory entries. It is this release and removal 
function that is performed by the NDA control statement option NR. 



NOTE 



Purging network dump files via the PURGE 
control statement leaves the dump directory file 
incorrect. Dump files should be purged only by 
NDA. 



NPU DUMP ON TAPE (NPUDUMP) 

NPUDUMP is a network procedure file that copies NPU dumps to tape. This procedure file can be called 
with the following command, 

X.BEGIN(NPUDUMP,NPUDUMP,dn) 

where dn is the NPU dump number. Up to five different dumps can be selected by repeated dn 
specifications, separated by commas. 

The effect of the NPUDUMP procedure is the same as the execution of the NDA control statement with 
NR specified (NPU dump is not purged) followed by a request for a labeled tape. The flashing tape 
request can be processed by the operator as described in the NOS Operator's Guide appendix on Network 
Failure Processing. If the NPUDUMP Procedure is executed after a network failure has occurred, no 
flashing tape request appears and the NPU dump is automatically copied to the same tape or set of tapes 
that was used for network dumps. If the network dumps had been printed instead, the NPU dumps are 
also printed. 
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UPDATE VSN(NETUVSN) 

NETUVSN Is a utility program that is used by network procedure files in order to collect a complete set 
of network dumps on one tape or set of tapes with a minimal amount of operator action. After a network 
procedure file copies its files to tape, it evokes NETUVSN, which reads the tape label to pick up the tape 
vsn, retrieves the device type from the tape FET, and uses this information to create a tape request 
control statement in a procedure file called NETTAPE. Other network procedure files call NETTAPE so 
that their network dumps are copied to the same tape or set of tapes. The format of such a dump tape is 
described in the following section. 



Network Dump Tape 

The network procedure files copy the network dumps to tape in a specific order and with specially 
marked records so that retrieval of the dump information is as simple as possible. The order of dumping 
is as follows: 

NAM 

RBF (if it was running) 

NS 

CS 

NVF 

TVF 

NPS (if it was running) 

NPU dumps 

For each product there can be several files that are dumped, but they are always dumped in a specific 
order as follows: 

Field length dump. 

Special files, if any (for example, NVF has TCR and DBG). 

AIP statistics file, if it exists. 

Job dayfile. 

AIP debug log file, if it exists. 

Each type of dump information is preceded by a text record that identifies the dump information. For 
NPU dumps, the text record is NPUDUMP=dn, where dn is the NPU dump number. Up to five different 
dumps can be included by repeated dn specifications, separated by commas. For all dumps except NPU 
dumps, the following text records are used, where name is the name of the product. 

text record Description 



name Indicates the first record of the AIP debug log file. 

name AIPS Indicates the record containing AIP statistics information. 

name DAYF Indicates the record containing the job dayfile. 

name DUMP Indicates the record containing the exchange package dump. After that 

is the field length dump. 

name END Indicates the end of the dumps for product name. 



4-8 60455380 D 



Not all of the records on the tape can be directly printed, because some of the dumped files are binary 
files instead of coded files. The TDUMP control statement (refer to volume 1 of the NOS Reference 
Manual) should be used to read the contents of all binary files, except for the AIP debug log file and the 
NPS file LOGNPS. The debug log file processor (DLFP) must be used to read the AIP debug log file, 
which is a binary file containing an indeterminate number of records. (Refer to the NAM Reference 
Manual.) This requires that the AIP debug log file first be removed from the tape and placed in a 
separate file. REPORTR must be run to read the NPS file LOGNPS. (Refer to the NPS Reference 
Manual.) This requires that LOGNPS first be removed from the tape and placed in a separate file. 



AIP TRACE WITH IAF 

The AIP trace utility produces a trace file of the messages transferred between IAF and NAM. This file, 
produced as a local file named ZZZZZDN at IAF's control point, contains information that can be useful 
in tracking network problems and in debugging application programs. However, the data in this file is in 
compressed format and hence the debug log file processor (DLFP) must be used to analyze the trace file. 
Refer to the Network Access Method Reference Manual for details about the trace output and the use of 
DLFP. 

The console operator selects whether or not to use the AIP trace mode of operation when entering the 
DSD command, IAFfff, to initialize IAF. This command selects a procedure file that contains the IAFEX 
control statement. The T parameter on the IAFEX statement determines whether or not AIP trace mode 
is to be in effect and also the number of messages that are to be contained on the trace file. The format 
of the IAFEX control statement is 

IAFEX(T=count) 

T=count 5000<count<9999999. Message count specifying the number of messages that are 

to be logged on the trace file before that file is released to the system for 
processing. If T=* is specified, the trace file is processed only after IAF is 
terminated. 

T Same as T=16200. 

T=0 AIP trace mode is not selected. 

T omitted Same as T=0. 

Two procedure files are provided for use with the AIP trace, IAFTM and IAFTR. Installations can define 
other procedure files using different T parameters on the IAFEX control statement. 



IAFTM 

IAFTM is a procedure file that contains the IAFEX(T=*) control statement. That is, the trace file 
ZZZZZDN is processed only after IAF is terminated. The IAFTM procedure file also includes the control 
statements necessary to process the ZZZZZDN trace file. Also, all messages logged on the trace file are 
written to the output file and then disposed to a printer. Refer to the NOS Installation Handbook for 
more information about IAFTM. 
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IAFTR 



IAFTR is a procedure file that contains the IAFEX(T) control statement. That is, the trace file 
ZZZZZDN is processed after every 16200 messages have been transferred between IAF and NAM. (Refer 
to the NOS Installation Handbook for more information about IAFTR.) An indirect access file called 
TRACIAF under user index 377777 8 is required to process the trace file. TRACIAF contains a control 
statement record, which is copied to the first record of the ZZZZZDN trace file. Trace information is 
then written to file ZZZZZDN, starting at the next record. This makes file ZZZZZDN suitable for 
submission as a batch job. The format of the TRACIAF file should be as follows- 



job statement 
USER statement 
CHARGE statement 



DLFP ( ... ) 



NOTE 



When system activity is very high, the potential exists for 
the following problems to occur if the AIP trace is used. 



• 



• 



If the system load remains at a very high level 
for a long period of time, a system hang due to 
PP saturation could occur. 

If mass storage requirements become great, the 
ZZZZZDN trace file could reach track limit. If 
so, IAF would stop and wait for resources to 
become available. 

Both of the proceding problems are unlikely to occur in 
most situations. Also, the risk of reaching track limit can 
be minimized by the selection of a message count on the 
IAFEX control statement that causes the trace file to be 
processed and released after the specified number of 
messages have been logged. This lowers the mass storage 
requirements. Because the AIP trace can be essential 
when certain types of problems are encountered, it is 
recommended that the AIP trace be used when 
circumstances so dictate as the risk involved is not great. 
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NETWORK DESCRIPTION FILES 

The network description files describe the physical and logical configuration of hardware and software 
elements that comprise the terminal network. They must be present for the proper functioning of the 
TELEX, TAF, and NAM subsystems of NOS. Depending on which subsystems are present at a site, one to 
five such files may be present for a single mainframe. Each file has the following unique function and/or 
construction. 



File Name 



LCF FILE and NCFFILE 



NETWidt 



Description 

Local configuration file and network configuration file which must be 
present if NAM is used. They are created by the Network Definition 
Language Processor (NDLP) from source text prepared according to 
specifications given in the Network Definition Language Reference 
Manual. 

Network description file which must be present if TELEX is used. It is 
prepared directly by the site analyst according to specifications given 
later in this section. If the Transaction Facility/Time-Sharing 
(multiplexer) version (TAF/TS) is used, NETWid is used by TELEX and 
TAF/TS. 



NHTRiHt 



Moturnnb 



-c:"i~ ...u:*u 



SIM Fid t 



me wnieii must De present n the Transaction 
Facility/NAM version (TAF/NAM) is used. It is prepared directly by the 
site analyst according to specifications given later in this section. 

Alternate network description file. This file is prepared in the same way 
as NETWid but is used by TELEX or TAF/TS when NETWid is unavailable 
or not present. The presence of SIM Fid is optional. SIM Fid is used 
primarily for system development purposes. 

Under standard operating conditions, the time-sharing and network subsystems expect these files to be 
permanent, direct access public files stored under the system user index (377777). LCFFILE and 
NCFFILE are binary files created by NDLP; NETWid, NCTFid, and SIM Fid (if used) are text files 
composed of directives. The text files are interpreted by code in common deck COMCRTN to produce 
tables used by TELEX or TAF during system operation (refer to COMCRTN listing). 

The alternate network description file SIM Fid is implemented so that a simulated network description 
can be retained and used without the necessity of changing the description of the actual physical network 
on the NETWid file. Accordingly, the analyst performs the following steps to obtain the simulated 
network description. 



t id is the two-character machine identifier as specified by the MID directive in CMRDECK (refer to 
the NOS Installation Handbook). 
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1. Stops the time-sharing executive. 

2. Attaches NETWid in write mode from the stimulation job. 

3. Initiates the time-sharing executive. (Since NETWid is attached in write mode, the 
time-sharing executive will attach the alternate file SIM Fid.) 

4. Begins stimulation. 

DIRECTIVE FORMATS 

A directive statement can be up to 90 columns but only columns 1 through 72 are interpreted. Any line 
containing an asterisk in column 1 is a comment and is ignored. 



Multiplexer Definition Directive 

The multiplexer definition directive must precede all other directives on the file and can be one of the 
following; no embedded blanks are allowed. 

//muxtype,CH=cc,EQ=eq 

muxtype Multiplexer model designation (6671 or 6676). 

cc Channel to which multiplexer is attached. 

eq Equipment number of multiplexer (0 to 7). 

This directive permanently associates a multiplexer with the terminals described by the terminal 
definition directives that follow. The //muxtype directive can appear only in the NETWid or SIM Fid file 
when used with TELEX or TAF/TS; it cannot appear in the NCTFid file used by TAF/NAM. 

//DIAL. 

This directive does not refer to any particular multiplexer or port. It requests that all terminals 
specified after it be assigned to whatever multiplexer ports are available when such assignment is 
needed. In the latter equipment assignment, no multiplexer port is permanently restricted to a fixed set 
of equipment. 



Terminal Definition Directive 

The following format shows the terminal definition directive. No embedded blanks are allowed. 

/termnam,p 1 =n 1 ,P2=n 2 ,...,p m =n m . 

termnam One- to seven-character alphanumeric name that uniquely identifies the terminal; 
termnam must be specified. When NCTFid is created, termnam must agree with 
any user name used by a terminal configured to access TAF/TS and with any 
automatic login user name. 
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Pi~ n i Description 

LS=n Terminal line speed in characters per second; (1 < n < 2047). This option 

cannot appear in NCTFid used by TAF/NAM. 

PL=n Last Port number used in conjunction with the PN option to establish the 

range of ports that can be used with one multiplexer. The PN option 
must precede PL. The range of n is (m+1) to 15 for 6671 multiplexers, 
(m+1) to 63 for 6676 multiplexers, and (m+1) to 512 for stimulated 
multiplexers, where m is the port number specified by the PN option. 
This option cannot be used in NCTFid used by TAF/NAM. 

PN=m Port number of the multiplexer with which the terminal is associated. 

This option is required only if the terminal is associated with a specific 
multiplexer equipment; that is, if the last preceding multiplexer 
directive was //6671 or //6676. The range of m is 1 to 16 for 6671 
multiplexers, 1 to 64 for 6676 multiplexers, and 1 to 512 for stimulated 
multiplexers. This option cannot be used in NCTFid used by TAF/NAM. 

Example: 

/TERMA, PN=2, PL=5. 

is a terminal definition which connects terminal TERMA to port 2 and 
limits the remaining terminal definitions in this set to ports 3 through 5. 

TT=tt or TT=*tt Terminal type that identifies the method by which the terminal is 

identified to the system and whether or not the terminal is a transaction 
terminal. 

tt Description 



AB Terminal is identified by answerback. 

ID Terminal is identified by terminal operator entry. 

If tt is preceded by *, the terminal is a transaction terminal. TT=*ID 
must be specified for terminals defined in NCTFid used by TAF/NAM. 

A TAF terminal is defined with the previous arguments, as well as the following, which are unique to 
TAF. 

Pi =n i Description 



DB=db. Two-character data base name to be used by the terminal. 

IS=stat Initial on/off status of the terminal; stat can be either ON or OFF. Default is ON. 

RS=n. Data base read security (0 through 7). Default is 0. 

UA=n. 24 bits defining the user argument area (0 through 77777777g). Default is 0. 

US=n. Data base update security (0 through 7). Default is 0. 



60455380 D 4-11 



VALNET VALIDATION PROGRAM 



VALNET is a program used to validate the syntax and logic of a terminal network description file. Errors 
in the network description are diagnosed and error messages entered on a list file. If no errors are 
encountered, no list is produced. If the network description is error-free, the analyst should then create 
a system file from the description file. This system file will be either SIM Fid or NETWid, depending on 
its use. Typical coding would be: 



X.DIS. 

USER(usernum,passwrd,family) 

GET,NET. 

SUI,377777. 

DEFINE,NETWid/CT=PU. 

VALNET,P=NET. 

COPYBF,NET,NETWid. 

The format of the control statement is 

VALNET(P=filenam,L=filenam,NR) 

P=filenam 



Tentative network description file is retrieved. 



P omitted 

L=filenam 

L 

L=0 

L omitted 

NR 

NR omitted 



Name of the terminal network description file to be diagnosed. 

Same as P=COMPILE. 

Same as P=NETWid. 

Name of file to receive error listing. 

Same as L=LIST. 

No error listing is to be produced. 

Same as L=OUTPUT. 

Network description file is not to be rewound before reading. 

Network description file is to be rewound before reading. 



OUTPUT LISTINGS 

For each error encountered in a network description file, VALNET produces two lines of listing. These 
lines have the following format. 



Error Line 



Statement 
Number 



Diagnostic Message 
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The error line is the faulty line, or in the case of an omission, a near subsequent line. As an example, the 
descriptive code 

(line 3) /TERMA. 

(line 4) /TERMB,PN=3. 

is missing the mandatory port number in line 3. However, this is not diagnosed until line 4 is 
encountered. Line 4 is listed along with the appropriate diagnostic as follows: 

TERMB,PN=3 

CARD 04 PORT NUMBER UNDEFINED FOR PREVIOUS TERMINAL. 

List lines are formatted for 72 columns except for input lines that exceed this length. 

VALNET calls common deck COMCRTN to process the multiplexer and terminal description directives. 
Refer to appendix A for descriptions of messages placed on the output file. 



STIMULATION 

A stimulator is a collection of central memory and peripheral processor programs which enters a 
hypothetical work load (called a session or script file) into the system to analyze the effects of such a 
load on response time and system reliability. The types of stimulation available are internal stimulation 
and external stimulation. During internal stimulation, the work load is entered into the system without 
external communications equipment or related terminals. An internal stimulator runs on the same 
mainframe as that being analyzed. During external stimulation, the work load is entered into the system 
via external communications equipment but without related terminals. An external stimulator can run 
either on the same mainframe being analyzed or outside this environment (on a second mainframe). 

The following stimulators are available to installations, depending on the control statement used in the 
STMfff procedure files (refer to Session File Processing later in this section). 

• STIMULA (internal stimulation of TELEX or IAF). 

• ASTIM (external stimulation of TELEX). 

• NSTIM (external stimulation of NAM and its applications). 

• NPS (internal stimulation of NAM and its applications). 

The STIMULA, ASTIM, and NSTIM stimulators consist of a central memory program (STIMULA) and two 
peripheral processor programs (ITS and 1TE). The NPS stimulator consists of three central memory 
programs (SCRIPT, STIM, and REPORTR) and a peripheral processor program (SIP). 
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To use the stimulators: 

1. Create the hypothetical load (refer to Session File Construction). 

2. Process these jobs using stimulator commands at the system console (refer to Session File 
Processing). 

Multiple stimulator sessions are described in Multiple Sessions section; errors that can occur while the 
stimulator software is in use are described in appendix A. 



STIMULA 

STIMULA is an internal stimulator that enters a work load into the system through TELEX or IAF. The 
stimulator software communicates directly with TELEX or IAF via a channel; when used with IAF, the 
load is applied directly to IAF without going through NAM. STIMULA can run either as the only front 
end in the system or in conjunction with live terminals. Only interactive terminals can be analyzed with 
STIMULA. The format of the control statement is as follows: 

STIMULA (I=filenam) 

filenam Local file to be used as the session file. If not specified, the initial K display 

(refer to figure 4-8) requests the session file name. 



ASTIM 

ASTIM is an external stimulator that enters a work load into the system through TELEX. Two 6676 
multiplexers are required. The stimulator software communicates with a TS multiplexer and TELEX 
communicates with a TT multiplexer.! The ports of the TS and TT equipment are hardwired together 
(figure 4-2). ASTIM can run either as the only front end in the system or in conjunction with live 
terminals. Only interactive terminals can be analyzed with ASTIM. The format of the control statement 
is as follows: 



ASTIM (I=filenam) 
filenam 



Local file to be used as the session file. If not specified, the initial K display 
(refer to figure 4-8) requests the session file name. 
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Figure 4-2. Hardware Configuration for ASTIM 



t Refer to the NOS Installation Handbook for the format of the TS and TT equipment types at 
CMRDECK time. 
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NSTIM 

NSTIM is an external stimulator that enters a work load into the system through NAM and its 
applications. A 6678 multiplexer (TS)f and an NP communications processor (255x) are required. The 
stimulator software communicates with the TS multiplexer, and the NAM software communicates with 
the NPU. The ports of the TS and NP equipment are hardwired together (figure 4-3). NSTIM can run 
either as the only front end in the system or in conjunction with live terminals. Only interactive 
terminals can be analyzed with NSTIM. The format of the control statement is as follows: 

NSTIM (I=filenam) 

filenam Local file to be used as the session file. If not specified, the initial K display 

(refer to figure 4-8) requests the session file name. 
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Fiemre 4-3. Hardware Confisruraton for NSTIM 



NETWORK PRODUCTS STIMULATOR (IMPS) 

NPS is an internal stimulator that enters a work load into the system through NAM and its applications. 
NPS can run either as the only front end in the system or in conjunction with a live network. Batch and 
interactive terminals can be analyzed with NPS. For further information on NPS, refer to the Network 
Products Stimulator Reference Manual. The remainder of this section contains information only about 
STIMULA, ASTIM, and NSTIM. 



SESSION FILE CONSTRUCTION tt 

A session (or script) file is an indirect access permanent file containing the hypothetical job load that is 
to be analyzed by the stimulator. A session file consists of a group of records: each record is a session 
and contains a hypothetical job that is composed of various entries with the following requirements. 



t Refer to the NOS Installation Handbook for the format of the TS and TT equipment types at 

CMRDECK time, 
ft Session file construction is independent of the stimulation mode except where otherwise noted. 
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1. Begin each internal stimulation session with the entry ANSWERBAC; this is a terminal type 
identifier to the time-sharing executive. (Other first lines may be used; however, ANSWERBAC 
is used in most cases.) A session used for external stimulation must not have this entry. If 
+CSET is the first line of an NSTIM script, NSTIM sends a ) and a © to the host for automatic 
character set detection by CCP. 

2. Enter each session entry on a separate line or card. 

3. After ANSERBAC (if required), enter a family entry (if required), a user number entry, and a 
password entry. An application name must also be entered for external stimulation of 
IAF/NAM. Ensure that PX=HALF is specified in the validation file for each user number (refer 
to section 2).t 

4. Specify the terminal commands and data. 

5. End each session with the command BYE so that the login of the next session is performed 
correctly. The HELLO command must not be used unless it is followed by a blank line. 

Figures 4-4, 4-5, 4-6, and 4-7 contain examples of session files. 



Dynami c Login 

If each of the terminals to be analyzed is logged into the system with a unique user number and password, 
a unique session record for each terminal is stored in central memory at the stimulator control point. 
Thus, a large amount of central memory could be unavailable to other components of the system. To 
alleviate this condition, dynamic login is possible, whereby one session record is generated with a unique 
user number and password which are dynamically translated into unique user numbers and passwords for 
each terminal at run time. The generated user numbers and passwords are then validated via system 
validation files. The formats are as follows: 

usernum$$$ 

or 
usernum$$$,passwrd$$$ 

usernum User number; one to four alphabetic characters. 

passwrd Password; one to four alphabetic characters. 

$ Special symbol 12/8/6 (display code 76), 1 (display code 34) punch; that is, 12/8/6 

punch in one column and 1 punch in next column. 

1 NOTE J 

The $ denotes the special symbol previously 
described, not the character itself. The $ 
character is translated into the stimulator 
terminal numbers at run time. 

Example: 

P$$$,P$$$ is translated into P000,P000 for the first terminal, into P001,P001 for the second terminal and 
so forth. 



t Does not apply to IA F. 
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ANSWERBAC 

BMS001 

NULL 

t t t t 

CA TLIST 

t 

t 

DAYFILE 

BYE 

*E-OR* 
ANSWERBAC 
BMSOOl 
NULL 
t t t t 
CA TLIST 
t 
t 

DAYFILE 
BYE 

*E-0-R* 
ANSWERBAC 
BMSOOl 
NULL 
MM 
C A TLIST 
t 
t 

DAYFILE 
BYE 

*E-0-R* 
$TASKO 50 
OLD.FILEO 
LIST 
LIST 
I 

*E-OR* 
$TASK1 30 
OLD,FILEl 
LIST 
LIST 
* 

*E-C-R* 
$TASK2 20 
OLD,FILE2 
LIST 
LIST 
t 

*E-0-F* 



Session record 



Session record 



Session record 



Task record 



Task record 



Task record 



Figure 4-4. Sample Session File With Tasks for Use by STIMULA 
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ANSWERBAC 

PERFDEV 

MATH, MATH 

CHARGE(7159, 73KDFA) 

>1 

FTNTS 

NEW, MATH 

10 PROGRAM MATH (INPUT, OUTPUT) 

20 1 CONTINUE 

30 READ 10,A 

40 IF(A.EQ.O) STOP 

50 B=A*A 

60 C=SQRT(B) 

70IF(A.LT. 0) D=-C**3 

80 CONTINUE 

90 IF(A.GT.O) D=C**3 

100 PRINT 20,A 

110 PRINT 30, B 

120 PRINT 40, D 

130 GO TO 1 

140 20 FORMAT^ A EQUALS *,F15.3) 

150 30 FORMA T(* A SQUARED = *,F15.3) 

160 40 FORMA T(* A CUBED - *,F15.3) 

170 10 FORMATU5.3) 

180 END 

>> 

RNH 

2.0 

0.0 

25 PRINT 50 

165 50 FORMATS ENTER VALUE *) 

LNH 

RNH 

1.0 

2.0 

3.0 

4.0 

0.0 

170 10 FORMAT(F12. 1) 

LNH 

RNH 

10.0 

11.1 

13.3 

0.0 

170 10 FORMAT(F12.3) 

LNH 

RNH 

15.555 

40.0 

50.0 

0.0 

LNH 

RNH 

10.0 

20.0 

30.0 

40.0 

0.0 

STATUS, T 

DAYFILE 

BYE 

Figure 4-5. Sample Session for Use by STIMULA 



Source line input 



Program input 
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PERFDEV 

MATH, MATH, IAF 

CHARGE(7159, 73KDFA) 

>1 

FTNTS 

NEW, MATH 

, 10 PROGRAM MATH (INPUT, OUTPUT) 

,20 1 CONTINUE 

,30 READ 10, A 

,40 IF(A.EQ.O) STOP 

,50 B=A*A 

,60 C=SQRT(B) 

,70 IF(A.LT.O) D=-C**3 

, 80 CONTINUE 

,90 IF(A.GT.O) D=C**3 

,100 PRINT 20,A 

,110 PRINT 30, B 

,120 PRINT 40, D 

,130 GO TO 1 

,140 20 FORMA T(* A EQUALS *,F 15. 3) 

, 150 30 FORMA T(* A SQUARED = *,F15.3) 

, 160 40 FORMA T(* A CUBED = *,F15.3) 

,170 10 FORMAT(15.3) 

, 180 END 

>> 



Source line input 
(Comma appears in first 
character position of each line. ) 



2.0 

0.0 

, 25 PRINT 50 

, 165 50 FORMA T(* ENTER VALUE *) 

LNH 

RNH 

1.0 

2.0 

3.0 

4.0 

0.0 

, 170 10 FORMA T(F12. 1) 

LNH 

RNH 

10.0 

11.1 

13.3 

0.0 

, 170 10 FORMAT(F12.3) 

LNH 

RNH 

15.555 

40.0 

50.0 

0.0 

LNH 

RNH 

10.0 

20.0 

30.0 

40.0 

0.0 

STATUS, T 

DAYFILE 

BYE, BYE 



Program input 
Source line input 
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Figure 4-6. Sample Session for Use by NSTIM 
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ANSWERBAC 

USERNUM 

PASSWRD 

BASIC 

OLD 

TESTB 

LIS, 294 

RUN 

01000 

REPLACE 

BYE 

*E-0-R* 



additional 
sessions 



*E-0-F* 
Figure 4-7. Sample Session File for Internal Stimulation 



ENTER STIMULATION FILE PARAMETERS IN FORM - 



SESSION FILE NAME. 

USER INDEX (OCTAL BASE ASSUMED.) 

NUMBER OF FILE ON SESSION FILE. 
BEGIN PROCESSING OF SESSION FILE 



p 


= 


VA 


LUE 


F 


= 






UI 


= 


OB 




N 


= 


1 




GO 









Figure 4-8. STIMULA Left-Screen K Display 



Source Line Input 



In sessions used for external stimulation, each source input line must begin with a comma as shown in 
figure 4-6. In sessions used for internal stimulation, commas indicating source line input are not required. 
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Optional Think Time Specification 

Think time is the number of seconds that each line is delayed before it is sent through the time-sharing 
system. A random think time can be specified with a session file command. The format of the command 
is as follows: 

>xxx 

xxx Think time (octal): xxx ^177g. 

To return the terminal to the initial think time (refer to figure 4-9), enter the following command. 
>> 



ENTER STIMULATION PARAMETERS IN FORM - 



P = VALUE (NUMERIC VALUES ARE ASSUMED DECIMAL BASE.) 

(SEE RIGHT SCREEN FOR SPECIAL PARAMETERS.) 

NT = 310B NUMBER OF TERMINALS TO STIMULATE. 

(1 - 100B) 
LS = 15 LINE SPEED IN CHARACTERS/SECOND. (1 - 1000) 

IS = 15 INPUT SPEED IN CHARACTERS/SECOND. (1 - 1000) 

TT = 10 THINK TIME DELAY IN SECONDS. (0 - 127) 

TI = 8 UPPER BOUND OF RANDOM THINK TIME INCREMENT. 

- 64 (MUST BE A POWER OF 2.) 

THINK TIME WILL VARY BETWEEN TT AND TT+TI. 

AC = 4 ACTIVATION COUNT. (1 - 64) 

NUMBER OF TERMINALS TO ACTIVATE EVERY 

AD SECONDS. 
AD = 10 ACTIVATION DELAY IN SECONDS. (1 - 127) 

RC = NUMBER OF TIMES TO REPEAT STIMULATION . (0-3 1) 

LD = LOGOUT DELAY. (0 - 4095) 

RO = ON OUTPUT RECOVERY. (ON OR OFF) 

LF = NO LOOP ON SESSION FILE (YES OR NO) 

TE = OFF EQUIPMENT ORDINAL FOR TRACE. 

TL = OFF LINE NUMBER TO TRACE. 



Figure 4-9. STIMULA Session File Parameters 
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Task Definitions 

A task is a predefined set of time-sharing commands designated by a task name and a task usage 
parameter. Tasks can be called throughout a session, and the task usage parameter is used to determine 
which task is the next most eligible task (that is, the task to be called next). 

An { character (display code 70) in the session calls the next most eligible task in the session file, which 
is determined by the following equation. 

Total initiations of task,- 

f, = — 1 



(Total initiations of all tasks) (Task usage parameter for taskj) 

For each taskj defined in the session file, the stimulator calculates fj, and the task with the smallest f 
value is the next most eligible task. Multiple \ characters are permitted on one line and are treated as if 
they occurred on separate lines. For example, fff calls the first three most eligible tasks, where 
eligibility is recalculated after each initiation of a task. If a task is called and the stimulator cannot 
determine the next most eligible task in the time allotted, the first task defined in the session file is used. 

Tasks for the stimulator are defined in the session file as task records following the session records. 
Tasks are not permitted in the file before session records. The tasks should be defined in descending 
order according to the task usage parameter. This facilitates the use of the first task defined as the 
default next most eligible task in situations where the stimulator fails to calculate the next most eligible 
task on time. 

The first line in a task record must be as follows: 

$task nnn 

$ Denotes the beginning of a new task (character position 1). 

task One- to six-character task name. 

nnn Task usage percentage; nnn 100 (character positions 8, 9, 10). The task usage 

percentages of all tasks in the session file must total 100. 

The last line in a task record must be a | character (display code 71), which returns control to the calling 
session. An example of a session file with tasks defined is shown in figure 4-4. 



SESSION FILE PROCESSING 

The stimulator software is used to process the time-sharing session file according to the following 
procedures. 

1. Ensure that a time-sharing subsystem stimulator entry is present in the EST whose status is ON 
(refer to the NOS Installation Handbook). The stimulator entry must be on an unused channel. 

2. Use DSD to stop the Remote Batch Facility or Export/Import. 

Type n.IDLE, where n is the control point number of the Remote Batch Facility or 
Export/Import as indicated on the B display. 
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3. Use DSD to bring the stimulator to the last available control point. 

Type STMffff. or STIMULATOR., where ffff is zero to four alphanumeric characters. This 
entry calls a procedure file STMffff, which must be a permanent indirect access file stored 
under the system user index (377777). The procedure file STM is called when the operator types 
either STM. or STIMULATOR. The stimulator is invoked by a STIMULA, ASTIM, or NSTIM 
control statement within the appropriate procedure file. 

The stimulator requests the K display at the control point. 

4. Type K,nn., where nn is the number of the last available control point. 
Figure 4-8 appears on the left display. 



5. 



Type the session file parameters individually as indicated in the following format column or as a 
group on the same line in the format. 



K.F=filenam,UI=userin,N=n,GO. 
Format Default 



K. F=f ilenam 
K.UI=userin 
K.N=n 

K.GO 



None 



None 



Significance 

filenam is the indirect permanent file name of the 
session file. 

userin is the user index of file filenam. The default 
family is assumed. 

n is the number of files to be skipped on file filenam 
before data is read from the session file; range is 
through 377777g. 

Indicates to the stimulator that all the parameters have 
been entered or that none are to be entered. 



Figure 4-9 appears on the left display. 
6. To display the special parameters, type: 
KK. 
Figure 4-10 appears on the right screen. 



TO ENTER MIXED MODE OF PARAMETER ASSIGNMENT - 



K. MIXED. 



Figure 4-10. STIMULA Special Parameters 
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7. Type the stimulator parameters individually as indicated in the following format column or as a 
group on the same line in the format. 

K.NT=n,LS=s,IS=s,TT=n,TI=i,AC=m,AD=d,RC=n,LD=d,RO=ON,GO. 

Enter any special parameters (figure 4-12) before the GO. entry. 

Format Default Significance 



K.NT=n 



K.LS=s 



Current EST 
value 



15 



K.IS=s 15 



K.TT=n 10 seconds 



K.TI=i 8 



K.AC=m 



K.AD=d 



10 seconds 



n is the current maximum number of terminals 
on which the time-sharing subsystem is ini- 
tialized. It must be less than or equal to 
the number specified in the EST entry; the 
range is 3 through lOOOg. 

s is the line speed in characters per sec- 
ond at which the operator wishes to run the 
terminals; the range is 1 through 1000. 
Any value above 60 characters per second 
causes a line speed of approximately 60 
characters per second. If many terminals 
(600g, for example) are run, the maximum 
realizable line speed is determined by the 
overhead of 1TD and ITS. The worst case 
can be determined by checking the 1TD cycle 
time dayfile message, which is issued when 
the time-sharing subsystem is dropped. For 
external stimulations, s should not exceed 
the hardware capability. 

s is the typing speed in characters per sec- 
ond at which the operator wishes to run the 
terminals; the range is 1 through 1000. For 
external stimulations, s should not exceed 
the hardware capability. 

n is the number of seconds (think time) 
that each line is to be delayed before it is 
sent to the time-sharing subsystem; the 
range is through 127 seconds. 

i is the number of seconds by which the 
think time will vary; the range is 
through 64 and i must be a power of 2. If 
i is nonzero, the think time varies between 
n (the value of TT) and n+i. 

m is the number of terminals that are to be 
logged in every d seconds (the value of AD); 
the range is 1 through n (the value of NT). 
The AC and AD options provide a method to 
stagger the I/O commands and data to the 
time-sharing subsystem. 

d is the number of seconds of delay time 
until the login of another terminal is al- 
lowed; the range is through 127 seconds. 
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Format 



Default 



Significance 



K.RC=n 



K.LD=d 



K.RO=o 



seconds 



ON 



n is the number of sessions that will be 
executed for each terminal; the range is 
through 31. 

d is the number of seconds of delay time 
after a logout is completed until the next 
login of the terminal is allowed; the range 
is through 127 seconds. 

When RO=ON, the output from the time-sharing 
subsystem is recovered on file STIMOUT. The 
format of this file is: 



59 


47 35 23 


11 













K.LF=o 



NO 



Terminal Each byte is an ASCII character 
number. if less than 40008; otherwise, 
it is the running-second time. 

When RO=OFF, the output is not recovered. 

When LF=NO, looping occurs on the session 
assigned to the terminal. When LF=YES, 
the subsequent session is the next session 
in the session file. 



K.TE=xx 



K.TL= 
ll"l2 



No equipment 
monitored 



No lines 
monitored 



K. MIX ED 



No mixed mode 

parameters 

entered 



K.GO 



xx is the equipment ordinal of the stimu- 
lated 6676 multiplexer (TS type) to be moni- 
tored. This entry is valid for external 
stimulation only. 

ll and I2 are terminal numbers that 
specify the range of lines on the equipment 
indicated by the TE parameter to be moni- 
tored. A single line (li=l2 or I2 not 
specified) can be specified. lj must be 
less than or equal to I2. This entry is 
valid for external stimulation only. 

Specifies that special parameter assignments 
are required for specific input sessions. 
This command displays the stimulation param- 
eter matrix (figure 4-11) whose values can 
be changed as described in the right screen 
K display (figure 4-12). 

Indicates to the stimulator that the param- 
eters are entered. Stimulation is initi- 
ated. 
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STIMULATION PARAMETER MATRIX 



SCRPT 


TTYS 


LS 


IS 


TT 


LD 




1 


40 


15 


15 


10 








2 


40 


15 


15 


10 








3 


40 


15 


15 


10 








4 


40 


15 


15 


10 








5 


40 


15 


15 


10 









RC 



NUMBER OF TTYS ASSIGNED = 200 
MAXIMUM TTYS PERMITTED = 200 
CF = MATRIX CHANGE FILE 



Figure 4-11. Parameter Matrix 
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DEFINITION OF PARAMETERS 



SCRIPT - SCRIPT(S) WHICH THE PARAMS WILL AFFECT 
(SCRIPT(N) OR SCRIPT(N)-SCRIPT(N+X)) 
TTYS - NUMBER OF TTYS ASSIGNED TO SCRIPT(S) 
LS - LINE SPEED ASSIGNED TO SCRIPT(S) 

IS - INPUT SPEED ASSIGNED TO SCRIPT(S) 

TT - THINK TIME ASSIGNED TO SCRIPT(S) 

LD - LOGOUT DELAY ASSIGNED TO SCRIPT(S) 

RC - REPEAT COUNT ASSIGNED TO SCRIPTCS) 



"NOTE - NULL PARAMETER WILL KEEP CURRENT VALUE 

TO MAKE ENTRIES, FOLLOW THE FORMAT - 
K.MX=SCRIPT,TTYS,LS,IS,TT,LD,RC. 



TO CHANGE MATRIX VIA PREDEFINED PARAMETERS- 

K.CF=XXX WHERE XXX IS PF CONTAINING CHANGE 
DIRECTIVES IN FOLLOWING FORMAT- 
MX=SCRIPT,TTYS,LS,IS,TT,LD,RC. 



TO ADVANCE DISPLAY ENTER K.+ 
TO BACKUP DISPLAY ENTER K.- 



Figure 4-12. Mixed Mode Parameters 
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Format 



Default 



K.MX= 

si"S2» 
ttys,ls, 
is,tt,ld, 
re 


Current 
value. 


K.CF= 
filenam 


None. 


K.+ 




K.- 




K.GO 





Significance 

Mixed mode input. s\ is the number of 
the first session to be changed, and S2 is 
the number of the last session to be 
changed. S2 is optional; the default is 
S]_. (Refer to figure 4-12 for other pa- 
rameter descriptions.) 

Matrix change file. Indirect access file 
filenam is accessed for mixed mode input 
directives, and must be saved under the same 
user index as the session file. 

Page matrix display forward one page. 

Page matrix display backward one page. 

Indicates to the stimulator that the param- 
eters are entered. Stimulation is initi- 
ated. 



Example: 

MX=2-4,3,30,30„,1. 

Three terminals will be assigned to sessions 2, 3, and 4. The line speed and input speed for these 
terminals will be 30 characters per second. The think time and logout delay will not be changed from the 
current value. The terminals will have a repeat count of one. 



MULTIPLE SESSIONS 

Each session on the session file is allocated to each terminal line. When each session has been allocated, 
the stimulator goes to the first session and reallocates the sessions to the next group of terminals. This 
procedure is repeated until all the terminals are allocated to a session. If a repeat count is not 
designated (RC parameter), the line is shut off when the session is finished. When the session completes, 
the repeat count is checked. 

The repeat count corresponds to the number of sessions to be executed on a given terminal. The current 
session is completed, and the LF parameter determines the next session to be executed. If LF=OFF, the 
session currently assigned to the terminal is repeated. If LF=ON, the next session in the session file is 
executed. For example, if the repeat count is four, the session currently assigned to the terminal is 
repeated four times (LFOFF), or the next four sessions on the session file (with repetition, if necessary) 
are executed (LF=ON). 



PARAMETER OUTPUT FORMAT 

The parameter information (shown in figure 4-13) is placed on the output file for printing upon 
completion of the stimulator run (refer to Session File Processing). 
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STIMULATOR PARAMETERS- 
SESSION FILE NAME- F= SSCC1 
USER INDEX- UI= 1 
NUMBER OF THE FILE- N= 1 
NUMBER OF TERMINALS- NT= 100B 
LINE SPEED- LS= 3 
INPUT SPEED- IS= 10 
THINK TIME- TT= 3 
RANDOM THINK TIME- TI= 
ACTIVATION COUNT- AC= 1 
ACTIVATION DELAY- AD= 1 
REPEAT COUNT- RC= 4 
LOGOUT DELAY- LD= 
OUTPUT RECOVERY- RO= ON 
LOOP ON SESSION FILE- LF= NO 
MATRIX CHANGE FILE- CF= 

STIMULATION PARAMETER MATRIX 



SCRPT 


TTYS 


LS 


IS 


TT 


LD 


RC 


1 


22 


30 


10 


3 





4 


2 


21 


30 


10 


3 





4 


3 


21 


30 


10 


3 





4 



NUMBER OF TTYS ASSIGNED = 64 
MAXIMUM TTYS PERMITTED = 64 



TASK 


CALLS 


COMPLETE 


DESIRED % 


ACTUAL % 


TASKO 
TASKl 
TASK2 


848 
509 
340 


818 
492 
327 


50.000 
30.000 
20.000 


49. 970 
29.994 
20.035 


TOTALS 


1697 


1637 


100.000 


99.999 



DEFAULT TASK CALLS = 15 



Figure 4-13. Output Statistics 
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POSTPROCESSING 

The postprocessing of the time-sharing stimulator output is accomplished by reading the file STIMOUT 
and sorting the data according to terminal number. This is accomplished by using the DEMUX control 
statement. As DEMUX sorts STIMOUT, it assigns an encounter number (starting at 1) to the output from 
each terminal session. DEMUX includes this number in the final line of each sorted terminal session 
output. The data for each terminal is separated by a page eject and an end of line indicator. The 
terminal data appears as it would on a terminal page. If the ASCII character on the STIMOUT file is 
40008 or greater, the lower 10 bits are assumed to be time of a carriage return or the first character of 
output. If STIMOUT will be processed at a later time, the user should save it. 

An example of output from DEMUX is as follows: 

ANSWERBAC 

*****TTT.TTT (Optional output) 

*****TTT.TTT (Optional output) 

yy/mm/dd.hh.mm.ss. 

CDC MULTI-MODE OPERATING SYSTEM NOS 1 



END OF THE LINE- 

(Page Eject) 
ANSWERBAC 



The n in the previous listing is the decimal encounter number. 
The format of the DEMUX control statement is 

DEMUX(p 1 ,p 2 ,...,p n ) 
where pj is either a keyword or a keyword equated to a value. 

Pj Description 

I=filenam 
I omitted 
NT=n 



NR 

0=filenam 
O omitted 
SL=termnum 



Name of the time-sharing output data file. 

Same as I=STIMOUT. 

Number of terminals to be sorted and extracted (0<n<512). This tells DEMUX 
how much memory to allocate to process the input file. 

Specifies that the input and output files are not to be rewound. 

Name of the processed (demultiplexed) output file. 

Same as 0=OUTPUT. 

Selective terminal number (within the range specified by the NT parameter) that 
specifies the data to be processed, termnum is the terminal number - 4 in the T 
display. 
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TR=filenam 

TR 

TR omitted 



Specifies that the time of each carriage return and first output character is 
written with the processed data. Subtracting the two time values gives the 
response time. The time values can also be used to correlate data between each 
terminal's input and output. 

Name of file on which analyzed stimulator monitor data (refer to the TE and TL 
parameters) is to be written. 

Same as TR=file specified by the O option. 

No postprocessing of monitored data occurs. 



The following is a partial listing of the monitored data from an NSTIM run. It is output from DEMUX. 



Time Port 



In 



Out 



JA 



DP 



10. 


020 


04 


1000 


NULL 


0000 


NULL 


2015 


4001 


2521 


20. 


025 


04 


1000 


NULL 


0000 


NULL 


2042 


0001 


2 521 


20. 


040 


04 


1000 


NULL 


4033 


CR 


2102 


0001 


2521 


20. 


055 


04 


1000 


NULL 


0000 


NULL 


2102 


0001 


2521 


24. 


540 


04 


5033 


CR 


0000 


NULL 


2102 


0001 


2521 


24. 


555 


04 


1000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


585 


04 


5000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


600 


04 


1000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


615 


04 


5000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


630 


04 


1000 


NULL 


0000 


NULL 


1643 


0001 


2 521 


24. 


645 


04 


5024 


LF 


0000 


NULL 


1643 


0001 


2521 


24. 


660 


04 


1000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


675 


04 


5000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


690 


04 


1000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


720 


04 


5024 


LF 


0000 


NULL 


1643 


0001 


2521 


24. 


735 


04 


1000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


750 


04 


5000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


765 


04 


1000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


780 


04 


5024 


LF 


0000 


NULL 


1643 


0001 


2521 


24. 


795 


04 


1000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


810 


04 


5000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


825 


04 


1000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


840 


04 


5024 


LF 


0000 


NULL 


1643 


0001 


2521 


24. 


855 


04 


1000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


885 


04 


5000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


900 


04 


1000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


915 


04 


5024 


LF 


0000 


NULL 


1643 


0001 


2521 


24. 


930 


04 


1000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


945 


04 


5000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


960 


04 


1000 


NULL 


0000 


NULL 


1643 


0001 


2521 


24. 


975 


04 


5024 


LF 


0000 


NULL 


1643 


0001 


2521 


24. 


990 


04 


1000 


NULL 


0000 


NULL 


1643 


0001 


2521 


25. 


005 


04 


5000 


NULL 


0000 


NULL 


1643 


0001 


2521 


25. 


020 


04 


1000 


NULL 


0000 


NULL 


1643 


0001 


2521 


25. 


050 


04 


5157 


7 


0000 


NULL 


1643 


0001 


2 521 
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Time Time in seconds and milliseconds. 

Port Port number. 

In Next input character to be processed. The first column is the input character 

from the channel. The second column is the display code mnemonic. 

Out Last output character. 

JA Jump address for internal processing within the stimulator. This is from the 

TOCA table in 1TE. 

DP Data pointers from internal processing within the stimulator. This is the first 24 

bits of the first word of the terminal table. 

The following dayfile messages are possible. 



END DEMUX RUN. 

ERROR DEMUX ARGUMENTS. 

SL OPTION OUT OF RANGE. 

TOO MANY TERMINALS. 



The DEMUX run is completed. 

An error exists in a calling parameter to DEMUX. 

The selective terminal number is greater than the number of 
terminals to sort. 

More than 511 terminals were designated with the NT parameter 
or the NT parameter exceeds the number of terminals to be 
analyzed that are defined in the stimulator EST entry. 



The following is an example of a procedure file called when STM. or STIMULATOR, is typed at the 
console. It executes the stimulator (STIMULA control statement) and performs postprocessing of the 
stimulator output. The procedure file must be stored as a permanent indirect access file under the 
system user index (377777). 



STM 

STIMULA. 

DEMUX(NT=310,O=NOS,T) 

GET(RESB/UN=usernum) 

RESB. 

ASSIGN(NE,TRASH) 
DFD(OP=I,L=TRASH) 

REQUEST(T) DROP TELEX. 



DFD(OP=I) 



ATTACH(ERRDATA/M=W) 

COPYEI(ERRDATA,OUTPUT) 

EVICT(ERRDATA) 

RETURN(ERRDATA) 

EXIT. 

DIS. 



Procedure file name. 

The stimulator is executed. 

RESB is a user-created program to analyze DEMUX 
output. 

The system dayfile is dumped to null equipment. 



Processing stops until IAF or TELEX is dropped. Also, 
ASSIGN,77 should be performed. (Refer to the NOS In- 
stallation Handbook.) 

A partial dayfile dump is performed which includes IAF 
or TELEX statistics. 

Output of all failing jobs is copied to output. 
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In the previous procedure file, output from failing jobs is copied from the file ERRDATA. In order for 
ERRDATA to contain this information, another procedure file is necessary to collect data on jobs that 
fail and place this data in ERRDATA. This procedure file (called ERRCHEK in the following example) 
should be called in the following manner after each stimulator session. 

GET,ERRCHEK/UN=usernum. 
CALL(ERRCHEK) 



The following is an example of this procedure file. 

ERRCHEK 
IF(EF=0)GOTO,99END. 



DISPLAY(EF) 
ASSIGN(MS,OUTPUT) 
ENQUIRE(A) 
DAY FILE. 



If certain jobs normally cause compilation 
errors, additional procedure should be included 
to allow for these special cases. 



Data is gathered on which program and which 
statement caused the error. 



ATTACH,ERRDATA/UN=usernum,M=W,NA. 

SKIPEI(ERRDATA) 

REWIND(OUTPUT) 

COPYEI(OUTPUT,ERRDATA) 

T> TJTITTTJ VlY/~kTTT!T»TTrri T?T» Tin AmA\ 

rvxii urvmwu i.r u i ,£<rtjai^rt. i t\) 

COMMENT. FAIL******************** 
COMMENT. FAIL******************** 
COMMENT. FAIL******************** 
COMMENT. FAIL******************** 
COMMENT. FAIL******************** 
COMMENT. FAIL******************** 
COMMENT. FAIL******************** 
COMMENT. FAIL******************** 
COMMENT. FAIL******************** 
COMMENT. FAIL******************** 
COMMENT. FAIL******************** 
COMMENT. FAIL******************** 
COMMENT. FAIL******************** 
EXIT. 
REQUEST(FAIL) ERRCHECK FAILED... 



99END(EXIT) 



This data is placed on file ERRDATA, which is 
used later during postprocessing. 



These comments warn users that failures have been 
encountered. 



If serious problems have been encountered, DIS 
could be brought up at this point. 



Care should be taken when comparing response times between different versions of the operating system 
with the stimulator. Other factors may have a significant impact on response time. Awareness of the 
following items is necessary. 

• The entire parameter set should be the same for each stimulator run. The rate of activation of 
terminals, for example, can significantly impact response time. 

• The hardware configurations must be identical. If an attempt is made to measure small 
differences, all devices which cannot be restored to their original state (normally temporary 
devices) should be deadstarted and fully initialized. 
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• If the possibility exists that permanent files have been destroyed, these files should be restored 
before each run. This can be accomplished easily by maintaining a copy of all required files 
under a user number not used during the stimulation. A procedure file can then be called to 
restore the files before each stimulator run. This is important when stimulation loads are 
causing abnormal job failures. A REPLACE shortly after an unexpected abort may cause 
incorrect information to be written, for example. 

• Job processing must be the same for each stimulator run. When many terminals are to be 
analyzed, random job failures may be overlooked. These failures may, however, affect the 
entire results of the stimulator run. To minimize this problem, it is necessary to check errors in 
all sessions quickly and easily. This can be done by using the procedures described earlier in this 
section. 

By using the preceding techniques and procedures and noting the restrictions, it becomes easier to use 
the stimulator to check performance and reliability and to obtain meaningful data from the system. 
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SYSTEM ACCOUNTING 



The user validation and user accounting capability of NOS is based on two special system files, VALIDUs 
and PROFILa. 

VALIDUs is used to control user validation, including 

• Who can use the system. 

• What resources they can use. 

• Limits on job resource usage. 

PROFILa is used to control user accounting, including 

• Who can be accounted for. 

• What accounting parameters are assigned. 

• Limits on time of day access to the system. 

• Limits on total resource usage. 

As the structures of the user validation file and user accounting file change, concurrent file name 
changes can also occur to make it easier for sites to convert from one system to another. In this manual, 
the user validation and accounting files are referred to as VALIDUs, VALINDs, and PROFILa. Table 5-1 
lists the file names corresponding to the appropriate operating system levels. 

TABLE 5-1. VALIDATION AND USER ACCOUNTING FILE NAMES 



System 


User 
Validation 
File 


User 

Indexes 

File 


User 

Accounting 

File 


KRONOS 2.1.1 


VALIDUX 


VALINDX 


PROFILO 


NOS 1.0 


VALIDUS 


VALINDS 


PROFILA 


NOS 1.1 


VALIDUZ 


VALINDZ 


PROFILA 


NOS 1.2, 1.3, and 1.4 


VALID UZ 


VALINDZ 


PROFILB 



VALIDUs contains user numbers and PROFILa contains charge-project numbers. User numbers identify 
the user, his set of permanent files, and his resource limitations. Charge-project numbers control and 
record billing charges. Entry of subsequent user numbers during a job session affects only permanent file 
usage and does not alter the billing procedure. Entry of subsequent charge-project numbers initiates a 
new sequence of billing computations. Initialization of the user validation and indexes files can be 
performed via the GENVAL utility described in section 7. 
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The billing unit which reflects the resources used by the system during a job or a session is called the 
system resource unit (SRU). The calculation of this unit provides for the flexibility of weighing the usage 
of resources against one another. The following resources are included in the calculation of this unit. 

• CM field length. 

• ECS field length. 

• CPU usage. 

• Mass storage usage. 

• Magnetic tape usage. 

• Permanent file usage. 

The parameters for SRU computation are related to the charge-project numbers. The PROFILa file 
contains indexes used to determine which SRU parameters are to be used for computation while a 
charge-project number is in effect for the job or session. 



USER VALIDATION (VALIDUs 1 - SPECIAL SYSTEM FILE) 

A special system file contains data necessary to control various aspects of system activity. (As a rule, 
this is privileged information requiring secrecy.) These files are maintained as direct access permanent 
files under the system user index 377777 8 . (User index is defined in section 1.) These files can only be 
accessed by special system jobs. 

Special system jobs are system routines which can only be initiated at the analyst's control point. They 
execute with benefit of f ile security and access to resources and system functions without user validation 
restrictions. 

The system-bound security of VALIDUs and PROFILat ensures that they will not be accessed by 
individual users either for curiosity or tampering. 

System file security does not preclude customers from establishing operational parameters for their own 
users. The analyst, in creating and updating PROFILa, can establish master users who can add, modify, 
and delete charge and project admissions for their own people. The master users are customer 
supervisors who manage the projects involved and are in the best position to determine what should be 
used and by whom it should be used. 

The VALIDUs file is created and managed by MODVAL. The PROFILa file is created and managed by 
PROFILE. These two managers are system program modules that, with input directives, constitute 
special system jobs used as system file processors. Special system jobs call the special file supervisor 
(SFS) which provides routines, table management, data manipulation, and I/O processing. 

An input directive contains the parameters used to define access information. The basic format of each 
parameter designation is: 

identifier = data 

identifier Control field within the file to be set. 

data Value to be set in that field. 

A brief overview of the creation and use of validation files is given in figure 5-1. 



f In this manual the user validation and accounting files are referred to as VALIDUs, VALINDs, and 
PROFILa. Refer to table 5-1 for a list of file names that correspond to the appropriate operating 
system levels. 
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SPECIAL SYSTEM FILE SUPERVISOR 

Provides routines, table management, data 
manipulation, and I/O processing for 
system file processors. 



MODVAL 

Validation File 
Manager 



Input Directives 



Special System Job 



PROFILE 

Project Profile 
Manager 



Input Directives 



Special System Job 



Special System File containing 
information required to validate 
a user's request for access to 
the system. 



£ 



LOGIN 



Special System File containing 
information required to validate 
o user's request for access to 
charge numbers and project numbers 



USER NUMBER 
VALIDATION 



User Number 
Password 











USER 











(Login) 



CHARGE NUMBER 
VALIDATION 



'harge Number 
Project Number 



SET AND LIMIT 
RESOURCE USAGE 



SET ACCOUNTING 
PARAMETERS 



Figure 5-1. Creation and Use of Validation and Accounting Files 
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The VALIDUs special system file contains the user numbers that validate individual user access to the 
operating system. A second level of security, the password, can also be specified. Associated with each 
user number defined in VALIDUs is a set of limits that specify the system resources available to the user 
in a single job. This set includes the following: 



Resource 



Equipment usage 



File usage 



Machine usage 



System usage 



Limits 

Maximum number of magnetic tapes this user may use. 

Maximum number of disk packs this user may use. 

Maximum number of mass storage PRUs this user may 
additionally allocate. 

On what master device the permanent files and 
catalog for each user will be stored. 

Maximum number, of lines printed or cards punched per 
output file. 

Maximum number of permanent files allowed. 

Maximum number of files while running. 

Maximum number of disposed output (such as print or 
punch). 

Ability to create direct access permanent files. 

Ability to create indirect access permanent files. 

Maximum size of direct or indirect access permanent 
files or cumulative size of all indirect access 
permanent files. 

Maximum number of dayfile messages written and 
control statements processed. 

Maximum CPU time for each job step. 

Maximum CM space. 

Maximum ECS space. 

Capability to submit system origin jobs. 

Capability to access system files. 

Number of deferred batch jobs. 
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Resource Limits 

Terminal usage (not used with IAF) Which terminals are valid for individual users. 

Terminal type. 

Transmission mode. 

Parity. 

Delay count. 
Application usage (NAM terminals only) Which network applications individual users may use. 

MODVAL VALIDATION FILE MANAGER 

The validation file manager, MODVAL, creates and manages the VALIDUs file and can be executed from 
the system console (system origin job) or via a batch job.t Refer to Examples of MODVAL Usage 
(example 14) for a description of the creation of initial VALIDUs and VALINDstt files. 

VALIDUs is a direct access permanent file. From the console, it can be created and updated via the K 
display. Batch input must first establish local files and then copy onto the direct access file. 

MODVAL CONSOLE INPUT 

All batch input directives (refer to MODVAL Batch Input) are available for console input. In addition, 
the following are provided specifically for console input. 

K.I,usernum Inquire option relative to the user identified by the user number 

usernum. Information is given on the second MODVAL display 
(figure 5-3). This option cannot be used for data entry. 

K.U,usernum Update modification for the user number usernum which is on 

the existing VALIDUs file. Modification data is input following 
the input of this directive. 

K.CjUsernum The user number usernum is entered on a VALIDUs file that is 

being created. The following input line(s) can contain 
identifiers for this user number. 

K.D,usernum The user number usernum is deleted from the existing VALIDUs 

file. 



t Although MODVAL can create the VALIDUs file from a batch job, the file thus created cannot be 

saved (refer to MODVAL Batch Input). 
ttUser validation and accounting files are referred to as VALIDUs, VALINDs, and PROFILa. Refer to 
table 5-1 for a list of file names that correspond to the appropriate operating system levels. 
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Information for the previous options is provided on two MODVAL displays (figures 5-2 and 5-3) for each 
user number specification. For the option types, identifiers must be entered on separate lines following 
the user number specification. 

K./usernum,ident=data This slash (/) directive is used to update usernum as with the U 

option; however, if usernum is not found, a new user number is 
created automatically. It is possible under this option to switch 
control directly from one user number to another without returning 
to the initial MODVAL display (figure 5-2). If the / directive is used 
exclusively, data entry is analogous to batch input; that is, the card 
image can be entered with user number and identifier on the same 
line. 

K.+ The plus (+) is used to toggle the user display pages (K display). 

The console options can be used by the analyst to access VALIDUs with the MODVAL manager according 
to the following general procedure. 

1. The analyst types: 

AB. 
X.MODVAL. 

2. The B display will appear on the right screen. This display gives a listing of the control points 
and what is assigned to each. The analyst notes the control point to which MODVAL is 
assigned. To the right of this entry will appear the flashing message: 

REQUEST K DISPLAY 

3. The analyst types in 

K,n. 
where n is the control point number noted on the B display. 

4. The first MODVAL display will appear on the left screen. This is a listing of the options 
available for manipulating the validation file VALIDUs (refer to figure 5-2). 

5. The analyst types in one of the five console options. This is either 

K.option,usernum 

or 

K./usernum,ident=data 

If a delete (K.D,usernum) is entered, the user number usernum is deleted from the validation 
file VALIDUs at this point. No further action is needed for this option. 
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VALIDUZ 



CREATED 77/06/15. 
UPDATED 78/03/14. 



INPUT DIRECTIVES ARE THE SAME AS BATCH INPUT DIRECTIVES. 
THE FOLLOWING DIRECTIVES ARE ALSO PROVIDED - 

/AN - TERMINATE INPUT FOR PRESENT USER NUMBER IF ANY, 

AND UPDATE VALIDUS FILE. INITIATE ACTION ON -AN- 

I, AN - INQUIRE OPTION. THIS DISPLAY ONLY. 

C,AN - CREATE OPTION. THIS DISPLAY ONLY. 

U,AN - UPDATE OPTION. THIS DISPLAY ONLY. 

D,AN - DELETE OPTION. THIS DISPLAY ONLY. 

+ - TOGGLE USER DISPLAY PAGES. 

END - COMPLETE UPDATE OR INQUIRE OF ACTIVE USER. FROM 
THIS DISPLAY, END RUN. 

DROP - TERMINATE INPUT FOR ACTIVE USER. 

STOP - TERMINATE INPUT FOR ACTIVE USER, IF ANY. END RUN 
AN = 1-7 CHARACTER USER NUMBER. 

DATA ENTRY FORMAT IS OF THE FORM MT=XX, PR=XX, TL=XX, ETC. 
ALL NUMERIC FIELDS ARE ASSUMED TO BE DECIMAL UNLESS A POST- 
RADIX IS SPECIFIED. FOR EXAMPLE - 
4000B 

ACCESS WORD IDENTIFIERS STARTING AT BIT ARE - 

CPWC CTPC CLPF CSPF CSOJ CASF CAND CCNR CSRP CSTP CTIM 
CUCP CSAP CBIO CPRT 

APPLICATIONS STARTING AT BIT 24 ARE - 
IAF RBF TAF MCS TVF NOP LOP NOPLOP 



Figure 5-2. First MODVAL Display 
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USER INSTALL PAGE 1 OF 3. 

CREATED 77/10/27. UPDATED 78/02/14. 

CONTENTS DESCRIPTION 

PW = EJHA PASSWORD (4-7 CHARACTERS). 

UI = 1915B USER INDEX (1-377777B). 

MT = UNLIMITED MAGNETIC TAPES (0-7). 

RP = UNLIMITED REMOVABLE PACKS (0-7). 

SC = 47B SECURITY COUNT (0-77B). 

MS = UNLIMITED MASS STORAGE PRUS (0-77B). 

CM = UNLIMITED CENTRAL MEMORY FL (0-77B). 

EC = UNLIMITED ECS FIELD LENGTH (0-77B). 

TL = UNLIMITED TIME LIMIT (0-77B). 

NF = UNLIMITED NUMBER OF LOCAL FILES (0-7). 

OF = UNLIMITED DISPOSED OUTPUT (0-7). 

DB = UNLIMITED DEFERRED BATCH (0-7). 

DS r SYSTEM DA FILE SIZE (0-7). 

FS = 6 ( 192) INDIRECT FILE SIZE (0-7). 

FC = SYSTEM PERMANENT FILE COUNT (0-7). 

CS = 2 ( 1024) INDIRECT SPACE (0-7). 

AW = 00000000002700017577 ACCESS WORD (3-4 CHARACTERS) 



Figure 5-3. Second MODVAL Display (Sheet 1 of 3) 
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CREATED 



CONTENTS 



LP = 
CP = 

PT = 
CC = 

DF = 

SL = 
CN = 

PN = 



AB = 



UNLIMITED 
UNLIMITED 

UNLIMITED 
UNLIMITED 



PA 


= 


EVEN 


RO 


= 


SYSTEM 


PX 


= 


HALF 


TT 


= 


TTY 


TC 


— 


STANDARD 


IS 


— 


NULL 



USER INSTALL PAGE 2 OF 3 

77/10/27. UPDATED 78/02/14. 

DESCRIPTION 

LINES PRINTED (Q-77B). 
CARDS PUNCHED (0-77B). 
UNITS PLOTTED (0-77B). 
CONTROL CARDS (0-77B). 
DAYFILE MESSAGES (0-77B). 



OB ( 8) SRU LIMIT (0-77B). 

CHARGE NUMBER (1-10 CHARACTERS ). 
PROJECT NUMBER (1-20 CHARACTERS). 



ANSWERBACK (0-10 CHARACTERS). 



TERMINAL PARITY (3-4 CHARACTERS). 
RUBOUTS (Q-37B), 
TRANSMISSION (i CHARACTERS). 
TERMINAL TYPE (3-7 CHARACTERS). 
CHARACTER SET (5-6 CHARACTERS). 
INITIAL SUBSYSTEM (4-8 CHARACTERS). 



AW = 00000000002700017577 



ACCESS WORD (3-4 CHARACTERS) 



Figure 5-3. Second MODVAL Display (Sheet 2 of 3) 



60455380 G 



5-9 



USER INSTALL PAGE 3 OF 3. 

CREATED 77/10/27. UPDATED 78/02/14. 
ON/OFF APPLICATION 



ON 


IAF 


ON 


RBF 


ON 


TAF 


OFF 


MCS 


ON 


TVF 


OFF 


NOP 


OFF 


LOP 


OFF 


NOPLOP 



Figure 5-3. Second MODVAL Display (Sheet 3 of 3) 



6. For a create, update, or inquire option, the second MODVAL display (figure 5-3) replaces the 
first on the left screen. 

For a create (either by C or /), the new user number will appear with default values for the 
parameters. If the ident is included with the slash (/), it will appear on the display but will not, 
at this point, be entered on the file. 

For an update (either by U or /), the existing user number will appear with current parameters. 
If a modification identifier is included with a / input, the new value will appear on the screen 
but will not be entered on the file. From here, the analyst would have to go to step 7. 

For an inquire, the display contains the information requested and the procedure would stop at 
this step. 

7. For a C or U option, the ident is now typed in with the format: 

K.ident=data 

8. To initiate action on the create or update entry, the analyst types: 

END 
If the analyst does not want this entry on the file, he can either type 

DROP 
and erase the entry without terminating this run, or he can type 

STOP 

and terminate the run without action on this entry. 

In the case of DROP, the first MODVAL display (figure 5-2) will return to the left screen and 
the analyst can enter more user numbers and their associated parameters. 
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To terminate any run without erasure, the operator types: 

END. 
Table 5-2 summarizes the basic input coding for console options. 

TABLE 5-2. INPUT CODING FOR CONSOLE OPTIONS 



Create 


Update 


Inquire 


Delete 


K.C,usernum 


K.U,usernum 


K.I,usernum 


K.D,usernum 


K.ident=data 


K.ident=data 


K.END 


K.END 


K.END 


K.END 






or 


or 






K./usernum 


K./usernum 






K.ident=data 


K.ident=data 






K.END 


K.END 







MODVAL BATCH INPUT 

Batch jobs that call the MODVAL validation file manager cannot make use of direct access permanent 
files, such as VALIDUs that are under the system user index 377777B. Accordingly, batch input to 
VALIDUs requires the use of user permanent files and local copies. The local versions are ultimately 
copied onto the direct access VALIDUs file via the console as a system origin job. 



The following files are used by MODVAL in batch processing. 
Default Name 



INPUT 

NEWVAL 

VALIDUs 
SOURCE 
VALINDs 

OUTPUT 



Use 



File containing the input data directives that will be used to create or 
update the validation file VALIDUs. 

Interim copy of the new validation file that is to be created or 
reformatted. 

Old validation file that is to be updated or reformatted. 

File to receive the source input for each user number. 

File containing all the available user indexes for the present VALINDs 
file. VALINDs is always used in conjunction with one of the validation 
files, new=NEWVAL or old=VALIDUs. 

File to receive output listings. 



60455380 D 



5-11 



The analyst performs the following procedure to create a new validation file with batch input. 

1. Submits a batch job that executes MODVAL to create a local copy of the new validation file. 
The job saves the file as a permanent file. 

2. At the console, he retrieves the permanent file created in step 1, defines the direct access file 
VALIDUs, and copies the new validation file to VALIDUs. 

The analyst performs the following procedure to use MODVAL via batch input to perform an update or 
other operation that deals with a preexistent validation file. 

1. At the console, the analyst attaches VALIDUs and makes a permanent file copy. 

2. He submits a batch job that retrieves the permanent file created in step 1, executes MODVAL 
to update the validation file, and saves the new validation file with any change incorporated. 

3. At the console, the analyst retrieves the permanent file created in step 2, defines the direct 
access file VALIDUs, and copies the new validation file to VALIDUs. 

Although MODVAL batch input is more involved than input made exclusively at the console, it will prove 
faster and more convenient when a long list of user numbers with many identifiers wil be entered. 



MODVAL Control Statement 

The MODVAL validation file manager is accessed with the MODVAL control statement. The following is 
the format of the statement. 



MODVAL (pi,p 2 ,...,Pn> 

where pj is a keyword or a keyword equated to a value. 

Pi Description 

I = filenam 



P = filenam 
N = filenam 
S = filenam 
U = filenam 
L = filenam 



Local file name of the file that will contain input data or source data; 
default is INPUT. 

Local file name of the copy of the old validation file that is to be 
updated or reformatted; default is VALIDUs. 

Local file name of the interim file that will become the newly created or 
reformatted validation file; default is NEWVAL. 

File that will receive source data for each user number; default is 
SOURCE. 

File containing the available user indices of the current VALIDUs file; 
default is VALINDs. 

File to receive list output; default is OUTPUT. 
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CV KRONOS 2.1.1 to NOS 1 conversion (OP=C option) or NOS 1 to KRONOS 

2.1.1 conversion (OP=S option). During a create run (OP=C), the creation 
of two user numbers with the same user index is allowed. Any identifier 
not recognized by NOS 1 MODVAL is ignored. During a source run 
(OP=S), the generation of identifiers not recognized by KRONOS 2.1.1 
MODVAL is suppressed. 



NOTE 



When a KRONOS 2.1.1 VALIDUX file is 
converted to NOS 1 VALIDUs format that is 
subsequently converted to source, VALIDUs 
fields identified MT, RP, TL, CM, NF, MS, and 
DB are converted from range indices to actual 
values. These values may not be identical to 
the original VALIDUX file values. 



RP Indicates that passwords do not have to be specified on a create run (can 

only be used with OP=C). RP should only be used if input (1=) file was 
created via an OP=S run on an existing user validation file containing 
passwords with length less than the installation required minimum. 

SI Specifies that the input for a create run (OP=C) was generated by a 

previous source run (OP=S). The automatic creation of the system and 
library user numbers is suppressed. 

D Indicates that MODVAL will not abort when directive errors are detected. 

FA Forces an attach of VALIDUs and VALINDs for system origin type jobs 

(for options OP=S, U, or R). 

FM=family Name of the family the user wishes MODVAL to access. This option can 

be specified only from a system origin job. 

SP Suppresses generation of application (AP) directives as a result of 

interpreting the application bits of the access word (bits 47 to 24) when 
returning the validation file to source (OP=S). Specifying SP is useful 
when returning a pre-NOS 1.3 validation file to source at a site that had 
previously assigned meanings to application bits or when returning a NOS 
1.3 or 1.4 validation file to source for subsequent use on an earlier 
system. 

OP=C Create option. Processes the input file and creates the interim 

validation file (N=NEWVAL) and the file of associated user indices 
(U=VALINDs). 

OP=C,LO=E Initiates the create (OP=C), and then lists errors encountered in 

processing. 
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OP=U Update option. Updates the local copies of VALIDUs and VALINDs with 

data on input file and sets NORERUN flag to prevent the job from being 
rerun and toggling validation bits twice. This option can be used with 
certain other options (for example, OP=URS). It is the default option for 
a nonsystem origin job or a system origin job where at least one 
parameter is specified on the MODVAL control statement. 

OP=U,LO=E Initiates the update (OP=U), and then lists the errors encountered in 

processing. 

OP=Z Statement update option. This is like the update option except that 

directives are included on the MODVAL statement. The Z parameter in 
this option must be used alone. 

OP=Z,LO=E Initiates the statement update (OP=Z), then lists the errors encountered 

in processing. 

OP=R Reformats the validation file by purging all files of each deleted user. 

Until this option is selected, all files of deleted users remain in the 
permanent file system even though they cannot be accessed. This allows 
redefinition of a user (with UI identifier on data input directive) if an 
error was made in deleting him. 

OP=S Specifies a source run that returns the validation file specified by the P 

identifier (default=VALIDUs) to source format (directive images) on the 
file specified by the S keyword (default=SOURCE). 

OP=K K display option. All other options (multiple OP specifications) are 

cleared, and instructions must be entered via the K display. 

OP=K is valid only for system origin jobs. The system files VALIDUs and 
VALINDs are automatically attached (the FA parameter is not necessary). 

For a system origin job, if no parameters are specified and the call 
statement is 

MODVAL. 

the K option is automatically selected. If parameters are specified, 
OP=U is the default. 

OP=I Inquire option. Gives a listing of validation parameters for the user 

specified by the last USER statement or by terminal login. This option 
must occur alone. The following is a sample list. This list is also 
obtained by using the LIMITS control statement (refer to volume 1 of the 
NOS Reference Manual for further information). 
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AB 


— » 


AB 


— j 


AB 


~ » 


AB 


~i 


MT = 


3, 


RP = 


2, 


TL = 


UNLIMITED, 


CM = 


2037B, 


NF = 


56, 


DB = 


8, 


FC = 


UNLIMITED, 


CS = 


4096, 


FS = 


64, 


PA = 


EVEN , 


R0 = 


SYSTEM, 


PX = 


HALF , 


TT = 


TTY , 


TC = 


STANDARD , 


IS = 


NULL , 


MS = 


12800, 


DF = 


1008, 


CC = 


UNLIMITED, 


0F = 


12, 


CP = 


UNLIMITED, 


LP = 


UNLIMITED, 


EC = 


OB, 


SL = 


UNLIMITED, 




CN =, 




PN =, 


DS = 


1024, 



AW = 00000000002700000555 

OP=L or OP=L,LO=A Reads the validation file, sorts the copy by user number, and writes it to 
the output file for listing according to the format in figure 5-4. 

OP=L,LO=N Reads the validation file, sorts the copy by user index, and writes it to 

the output file for listing according to the format in figure 5-4. 

OP=L,LO=L Reads the information on the local file identified in the parameter list, 

sorts by user number, and writes it to the output file for listing according 
to the format in figure 5-4. 

OP=L,LO=AL Same as LO=L since A is a default value. 

OP=L,LO=NL Reads the information on the local file identified in the parameter list, 

sorts the copy by user index, and writes it to the output file for listing 
according to the format in figure 5-4. 
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OP=L,LO=En 

or 
OP=L,LO 

OP=C,LO=EN 

U 
Z 
or 
OP=C,LO 
U 
Z 



File will be sorted by user index. 



Produces a list of errors for the C, U, or Z processing. In this case, 
MODVAL will use whichever applies. 



USER 
NUMBER 

USERAAA 
USERBBB 
USERCCC 



MODVAL, OP=L,LO=L. 



USER 
INDEX 



CREATION 
DATE 



LAST MOD 
DATE 



2 77/06/15. 78/02/14 

52 77/06/15. 78/02/1** 

3014 77/06/15. 78/02/14 



78/04/20. 15.51.10 



PAGE 



LIBRARY 377776 77/06/15. 78/04/13. 
SYSTEMX 377777 77/06/15. 78/04/13. 



Figure 5-4. Format of VALIDATION File Listing 



Input Directive 

An input directive enters user numbers under a create run (OP=C) and modifies existing user numbers 
under an update run (OP=U). Format of the input directive is 

/usernum,identl=datal,ident2=data2,... 

where usernum is the one- to seven-character user number being referenced and identpdataj is a system 
usage definition for this number. Valid characters for usernum are A through Z, through 9, and *. The 
user number statement must begin with a / in column 1. The user number and all directives must be 
terminated by a separator. 

Valid separators include any character whose display code value exceeds 44g (except /, =, and blank), as 
well as end-of-line. Thus, if an input directive item is last on a statement, no other separator need 
follow it. An asterisk (*) can separate all directives except user numbers, charge numbers, and project 
numbers. 

All directives relative to a user number must appear before another user number or the end of the input 
stream is encountered. 

All data within a user number entry is free format to column 72. A directive cannot be split between 
cards or lines. Blanks are ignored. 
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To allow sequencing and/or identification of input directives, all data past column 72 is ignored. 

Example: 

The following is acceptable. 

/ROBERTR,AW=CSPF 

AW=CLPF 
However, data cannot lap from statement to statement. 
Example: 
The following is not acceptable. 

/ROBERTR,AW=CSPF,AW= 

CLPF. 
The following is a list of identifiers and their descriptions. 



Identifier 



PW = passwrd 



UI = userin 



SC = nnr 



AB = answerback 



Description 

A four- to seven-character password (A through Z, through 9). Blanks 
are not significant. The minimum required length for passwords can be 
changed by setting the MODVAL installation parameter RPWL to a value 
from to 7. The PW identifier is required with OP=C unless the RP 
identifier is specified on the MODVAL control statement or the minimum 
required password length is zero. If this identifier is not required and is 
omitted, the system assigns a password of all blanks. In the latter case, 
the user must enter a null password at login. 

User index to be assigned to this user. If this entry is not supplied, the 
system assigns the next available user index, userin consists of six 
numeric characters followed by a radix. Blanks are suppressed. The 
maximum value is 377777g. This identifier cannot be used with the K 
display or update option. 

Security count. This parameter specifies the number of security 
violations allowed before the user is denied access to the system. The 
security count is decremented by the system when illegal secondary user 
statements are entered. A value of 77g indicates an unlimited security 
count; indicates no access is allowed. If not specified, the default 
value is SC=50g. The security count is not included as output from a 
LIMITS or MODVAL (OP=I) control statement. 

A 1- to 10-character answerback code. Blanks are significant. The 
answerback code restricts the user to a particular terminal. Up to four 
answerback entries are permissible per user number. If this identifier is 
omitted, the system supplies an answerback code of all blanks, which 
gives this user access through any terminal. AB applies only to 
Time-Sharing Module (not IAF) users. 
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Identifier 


MT 


= n 


RP 


= n 


TL 


= nnr 



Description 

Number of magnetic tapes allowed; n<7. If n=7, unlimited tapes are 
allowed. If this identifier is omitted, the system supplies a value of 0. 

Number of removable disk packs allowed; n<7. If n=7, unlimited disk 
packs are allowed. If this identifier is omitted, the system supplies a 
value of 0. 

Range index representing the maximum CPU time that a user's job step 
may run. nnr consists of two numeric characters followed by a radix. 
Blanks are suppressed. The maximum index value is 77g, which specifies 
unlimited CPU time for each job step. If this identifier is omitted, the 
system supplies an index value of 0. The system uses the formula 

maximum CPU time = ((index x iqo 8 ) + KTLI) x 10 8 t 

to convert the index value into the maximum CPU time that a user job 
step may run. 

DF = imT Range index representing the maximum number of MESSAGE requests 

the user can issue to the system and/or job dayfiles. nnr consists of two 
numeric characters followed by a radix. Blanks are suppressed. The 
maximum index value is 77 8 , which specifies unlimited MESSAGE 
requests. 

If this identifier is omitted, the system supplies an index value of 0. The 
system uses the formula 

maximum MESSAGE requests = (index x 20 8 ) + KDFIt 

to convert the index value to an actual limit of job MESSAGE requests. 

CC = nnr Range index representing the maximum number of batch control 

statements processed for a user, nnr consists of two numeric characters 
followed by a radix. Blanks are suppressed. The maximum index value is 
77 8 , which specifies unlimited batch control statement processing. If 
this identifier is omitted, the system supplies an index value of 34 8 . The 
system uses the formula 

maximum control statements = (index x 20 8 ) + KCClt 

to convert the index value to an actual limit of control statements 
processed. 



t Refer to the NOS Installation Handbook for a description of these COMSACC parameters. 
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Identifier Description 

OF = n Range index representing the maximum number of job print and punch 

files the user can dispose to the output queue; n<7. If n=7, an unlimited 
number of disposed output files is allowed. If this identifier is omitted, 
the system supplies an index value of 1. The system uses the formula 

maximum disposed output = (index x 4) 

to convert the index value to an actual limit of disposed output files. 

CP = Ymr Range index representing the number of cards that can be punched from 

a user's disposed punch file, nnnr consists of two numeric characters 
followed by a radix. Blanks are suppressed. The maximum value is 773, 
which specifies unlimited punched output. If this identifier is omitted, 
the system supplies an index of 0. The system uses the formula 

cards punched = (index x 100g) + KCPIt 

to convert the index value to an actual limit of cards punched from a 
disposed file. 

LP = nnr Range index representing the number of lines that can be printed from a 

user's disposed print file, nnr consists of two numeric characters 
followed by a radix. Blanks are suppressed. The maximum value is 77g, 
which specifies unlimited print output. If this identifier is omitted, the 
system supplies an index value of 0. The system uses the formula 

lines printed = (index x 2000 8 ) + KLPIf 

to convert the index value of an actual limit of lines printed from a 
disposed output file. 

PT = nnr Range index representing the number of plot units a user is allowed, nnr 

consists of two numeric characters followed by a radix. Blanks are 
suppressed. The maximum value is 77g, which specifies an unlimited 
number of plot units allowed. If this identifier is omitted, the system 
supplies an index value of 0. The system uses the formula 

plot unit limit = (index x 2000g) + KPTIf 

to convert the index value of an actual limit of plot units that a user may 
have. 

EC=nnr Range index representing the maximum ECS memory space a user is 

allowed, nnr consists of two numeric characters followed by a radix. 
Blanks are suppressed. The maximum value is 77 g, which specifies all 
ECS memory space of the machine. If this identifier is omitted, the 
system supplies an index of 0. The system uses the formula 

ECS limit = (index x 20g) + KECIt 

to convert the index value to an ECS memory limit expressed in units of 
lOOOg words. 



t Refer to the NOS Installation Handbook for a description of these COMSACC parameters. 
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Identifier Description 

SL = nnr Range index representing the maximum SRU accumulation for a user's 

job. nnr consists of two numeric characters followed by a radix. All 
blanks are suppressed. The maximum index value is 77g, specifying 
unlimited SRU accumulation. If this identifier is omitted, the system 
supplies an index value of 0. The system uses the formula 

maximum SRU accumulation = ((index x i00g) + KSLI) x lOgt 

to convert the index value into the maximum SRU accumulation that a 
user's job may have. 

CM = nnr Range index representing the maximum central memory space a user is 

allowed, nnr consists of two numeric characters followed by a radix. 
Blanks are suppressed. The maximum value is 77g, which specifies all 
available CM space of the machine. If this identifier is omitted, the 
system supplies an index value of 14g. The system uses the formula 

CM limit = (index x 40 8 ) + KCMlt 

to convert the index value to a CM space limit expressed in units of IOO3 
words. 

NF = n Range index representing the maximum number of files a user can 

concurrently utilize; n<7. If n=7, an unlimited number of concurrent 
files is allowed. If this identifier is omitted, the system supplies an index 
of 2. The system uses the formula 

concurrent files = (index x 10g) + KNFIt 

to convert the index value to an actual limit of concurrent files. 

MS = nnr Range index representing the maximum number of mass storage PRUs 

the user is allowed to additionally allocate, nnr consists of two numeric 
characters followed by a radix. Blanks are suppressed. The maximum 
value is 77g, which specifies unlimited additional mass storage PRUs. If 
this identifier is omitted, the system supplies an index value of 1. The 
system uses the formula 

PRU limit = (index x lOOOOg) + KMSIt 

to convert the index value to a PRU equivalent of the actual mass 
storage tracks additionally allocated to the job files. 

DN = n Range index representing the maximum number of deferred batch jobs 

the user is allowed to have in the system concurrently; n<7. If n=7, an 
unlimited number of deferred batch jobs is allowed. If this identifier is 
omitted, the system supplies an index value of 0. The system uses the 
formula 

deferred batch jobs = (index x 2) 

to convert the index value to an actual limit of deferred batch jobs. 



t Refer to the NOS Installation Handbook for a description of these COMSACC parameters. 
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Identifier 



AW = xxxx 



Description 

If the user has the access bit CSOJ and DEBUG is set on the system 
display console, the user has system origin or DB=0, the DB parameter is 
ignored, and the user may submit as many jobs as he wishes. 

xxxx is a four-character designation that toggles a particular bit in the 
access word (bits 59 through 48 and 23 through only). For each bit that 
is set, special permission is allowed to that user. The bit is set when the 
first identifier is encountered and cleared if the identifier is used again. 
A maximum of 36 entries per record is allowed. Blanks are suppressed. 

The following permission bits are defined in the access word. 



xxxx 


Bit 


CPWC 





CTPC 


1 


CLPF 


2 


CSPF 


3 


CSOJ 


4 



CASF 
CAND 

CCNR 

CSRP 



Permission 

User can change his password. 

User can use the access subsystem commands 
(terminal use only).t 

User can create direct access permanent files. 

User can create indirect access permanent files. 

User can have system origin capability from any 
job origin if the debug option is turned on by the 
operator. 

User can also assign a device by specifying its EST 
ordinal. This does not require that the debug 
option be turned on. 

User can also call the PP hardware diagnostics of 
the 881/883 pack reformatting utility FORMAT, if 
ENGINEERING mode is enabled. 

User can access system files (library). 

User can request nonallocatable devices (for 
example, magnetic tape units). 

User can use system without entry of charge or 
project number. 

User can issue auxiliary device commands. 



t Refer to the NOS Time-Sharing User's Reference Manual or the IAF Reference Manual for a 
description of the access commands. 
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Identifier Description 

xxxx Bit Permission 

CSTP 9 User can access special transaction functions. 

CTIM 10 User is not logged off because of timeout. 

CUCP 11 User can access system control point (SCP) 

facility. 

CSAP 12 User has special accounting privileges.t 

CBIO 13 User has BATCHIO subsystem privileges, tt 

CPRT 14 User can use PROTECT ECS statements. 

The default values are CPWC, CLPF, CCNR, and CSPF. 

To set or clear all permission bits in the access word (bits 59 through 48 
and 23 through 0), the following can be specified for xxxx. 

ALL Sets all 36 permission bits in the access word. 

NUL Clears all 36 permission bits in the access word. 

AP = appl appl is a one- to seven-character application name that toggles a 

particular bit in the application permission field (bits 47 through 24) of 
the access word. If more than one application corresponds to a single 
bit, any of the application names for that bit may be specified for appl. 
For each bit that is set, a specific application or set of applications is 
accessible to the user. A maximum of 24 entries per record is allowed. 
Blanks are suppressed. 

The following application bits are defined in the access word. 

appl Bit Application 

IAF 24 Interactive Facility 

RBF 25 Remote Batch Facility 

TAF 26 Transaction Facility 

MCS 27 Message Control System 

TVF 28 Terminal Verification Facility 

NOP 29 Network Operator 

LOP 30 Local Operator 

NOPLOP 31 Network/Local Operator 



t Refer to User Accounting for a description of special accounting user privileges. 
ttv carriage control character (refer to the NOS Reference Manual, volume 1). 
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Identifier 



CAB = oldab,newab 



Description 

The Network Validation Facility is automatically available to all NAM 
users; hence, no bit position is defined for this application. By default, 
no other applications are available to the user (bits 47 through 24 are 
zero). 

To set or clear all application bits in the access word, the following can 
be specified for appl. 

ALL Sets all 24 application bits in the access word. 

NUL Clears all 24 application bits in the access word. 

Indicates that the answerback code is to be changed. The entry consists 
of two fields, the first (oldab) indicates the answerback code that is to be 
changed and the second (newab) indicates the new code. An entry 
consists of 1 to 10 alphanumeric characters. Blanks are not suppressed. 
Four or less answerback changes are permitted per record. 



The following identifiers can only be used in update (OP=U) and K display options. 
Identifier Deserintion 



DAC = usernum 



FUI = userin 



Deletes the user number, usernum, from the VALIDUs file. This user 
number must match the current user number as specified after the most 
recent /. 

Forces the specified user index to be assigned to the user number 
specified after the most recent /, whether the user index is assigned to 
another user number or not. If the VALIDUs file is returned to source 
format (OP=S on MODVAL statement) and a new VALIDUs file created 
from this source, multiple user number per user index associations will be 
lost. 

The following four specifications control permanent file access for the individual user. Ordinarily, this is 
specified by origin type. 



Identifier 



FC =n 



Description 

File count indicating the maximum number of permanent files allowed 
the user. The user is validated for the upper limit corresponding to the n 
value specified. 

n Upper Limit Allowed (Octal) 






Use job origin control 


1 


10 


2 


20 


3 


30 


4 


40 


5 


50 


6 


100 


7 


Unlimited 



If FC is not specified, n=0 will be assumed. 
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Identifier Description 

CS=n Cumulative size of all indirect access files for this user. The user is 

validated for the upper limit corresponding to the n value specified. 

Upper Limit Allowed 
n (Octal Count of PRUs) 






Use job origin control 


1 


1000 


2 


2000 


3 


5000 


4 


10000 


5 


50000 


6 


100000 


7 


Unlimited 



If CS is not specified, n=0 is assumed. 

FS=n Maximum file size allowed for an individual indirect access permanent 

file. The user is validated for the upper limit corresponding to the n 
value specified. 





Upper Limit Allowed 


n 


(Octal Count of PRUs) 





Use job origin control; no controls are enacted. 


1 


10 


2 


30 


3 


50 


4 


100 


5 


150 


6 


300 


7 


Unlimited 



If FS is not specified, n=0 will be assumed. 

DS=n File size allowed for an individual direct access permanent file. The user 

is validated for the upper limit corresponding to the n value specified. 

Upper Limit Allowed 
n (Octal Count of PRUs) 






Use job origin control 


1 


1000 


2 


2000 


3 


5000 


4 


10000 


5 


50000 


6 


100000 


7 


Unlimited 



If DS is not specified, n=0 is assumed. 
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The following four specifications manipulate fields describing the Time-Sharing Module user's terminal; 
they do not apply to IAF. 

Identifier Description 



PX = mode Specifies transmission mode. Only one entry should occur per user 

number record. Since the terminal operates in full or half duplex mode, 
either of the following values is available for mode. 

mode Explanation 



FULL System enters echoplex mode automatically. 

HALF System does not enter echoplex mode automatically. 

RO = nnr nnr consists of two numeric characters followed by a radix. Blanks are 

suppressed. This is the rubout count which is the character count delay 
associated with the user's terminal. One value from to 37g may be 
entered for each user number record. A value of 37g denotes that the 
system will use the default number for the user's terminal type. 

PA = p p specifies terminal parity. The terminal operates with even or odd 

parity. One of the following two values may be entered for each user 
number record. 

EVEN 

ODD 

TT = t t specifies the terminal type. One of the following values may be 

specified for each user number. 

t Description 



TTY Teletype or other ASCII compatible terminal 

MEMAPL Memorex 1240 with APL print 

COR Correspondence with standard print 

CORAPL Correspondence with APL print 

BLKEDT Block mode terminal 

713 CDC 713 display terminal 
The following two specifications may be used with either Time-Sharing Module or IAF users. 
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Identifier 



TC =c 



IS = subsys 



CN = chargenum 



PN = projectnum 



Deseription 

Default character set to be used by the terminal. One of the following 
values is available for each user number. 

c_ Description 

STANDARD ASCII Graphic 63- or 64-character set 

ASCII ASCII 128-character set 

Initial subsystem for the terminal. One of the following values may be 
specified for each user number. 



subsys 



Description 



ACCESS Access subsystem 

BASIC BASIC subsystem 

BATCH Batch subsystem 

EXECUTE Execute subsystem 

FORTRAN FORTRAN Version 5 subsystem 

FTNTS FORTRAN Extended Version 4 subsystem 

NULL Null subsystem 

TRANACT Transaction subsystem (TAF/TS)t 

A 1- to 10-character charge number associated with the user. Valid 
characters are A through Z, through 9, and *. This field is not checked 
or updated by the system; it only provides information when OP=I is 
specified. To maintain correct information, this parameter should be 
updated when the user's charge number information is updated. 

A 1- to 20-character project number associated with the user. Valid 
characters are A through Z, through 9, and *. This field is not checked 
or updated by the system; it only provides information when OP=I is 
specified. To maintain correct information, this parameter should be 
updated when the user's project number information is updated. 



EXAMPLES OF MODVAL USAGE 

The examples in this section give representative commands for exercising the MODVAL options both at 
the console and by batch input. System files are under index 3777778. Refer to section 7 for definition 
of the ISF control statement. 



t TRANACT cannot be specified for IAF terminal users. AP=TAF should be used instead. 



5-26 



60455380 G 



Example 1: 

Example 1 is a create at the console with the C,usernum format, MODVAL is called and the B display 
indicates the control point for the job (n). This is entered via the K display. Following this is an entry of 
three user numbers with a password ident for each. 

X.MODVAL. 

K,n. 

K.C,USER201 

K.PW=ADMIT1 

K.END 

K.C,USER202 

K.PW=ADMIT2 

K.END 

K.PW=ADMIT3 

K.END 

K.END. 
Example 2: 
In example 2, the previous parameters are entered at the console with the / format. 

X.MODVAL. 

K,n. 

K./USER201,PW=ADMIT1 

K./USER202,PW=ADMIT2 

K./USER203,PW=ADMIT3 

K.END 

K.END. 
Example 3: 

In example 3, the same entries are made as a batch job with default values used for the file names. The 
following is the statement input. 
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Job statement 

USER(usernum,passwrd,family) 

MODVAL(OP=C) 

SAVE(NEWVAL) 

SAVE(VALINDs=VAL) 

7/8/9 

/USER201,PW=ADMIT1 

/USER202,PW=ADMIT2 

/USER203,PW=ADMIT3 

6/7/8/9 

This produces indirect access permanent files. These will be made direct access permanent files in the 
system from the console. The system index (377777) must be specified. The third parameter on the 
COPY command initiates verification of the files after execution of the copy. Input at the console is: 

X.DIS. 

USER(usemum,passwrd,family) 

or SUI,userin where user in is the user index for usernum. 

GET,NEWVAL. 

GET,VAL. 

SUI,377777. 

If a VALIDUs file already exists on the system, it will be necessary, at this point, to enter the 
following from DSD:t 

IDLEFAMILY,xx. where xx is the EST ordinal of the device to be idled. 

When the user count is zero (idle family situation), the IDLEFAMILY command must be entered 
again so that the system will accept the ISF control statement. 

IDLEFAMILY,xx. 

ISF(R=VALIDUs,FM=family) 

PURGE(VALIDUs,VALINDs) 



tBefore ISF(R=VALIDUs) can be entered, the system must be emptied of all executing jobs. This can be 
a time-consuming task. Refer to the NOS Operator's Guide for more information about the 
IDLEFAMILY command. 
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DEFINE, VALIDUs,VALINDs. 

COPY,NEWVAL,VALIDUs,V. 

COPY,VAL,VALINDs,V. 

RETURN, VALIDUs,VALINDs. 

ISF. 

Example 4: 

In example 4, the previous create is run with file names supplied. It is assumed that the following 
indirect access file is on mass storage before the batch deck is submitted. 

File PUTIN: 

/USER201,PW=ADMIT1 

/USER202, PW=ADMIT2 

/USER203,PW=ADMIT3 
Input at the card reader is: 

Job statement 

USER(usernum ,passwrd,f amily) 

GET,PUTIN. 

MODVAL,OP=C,I=PUTIN,N=VALNEW. 

SAVE,VALNEW. 

SAVE, VALINDS=VALX. 

6/7/8/9 
After this job is executed, the following entries are made at the console. 

X.DIS. 

Under DIS: 

USER (usernum, pass wrd,f amily) 

or SUi,userin. where userin is the user index for usernumber. 

GET,VALNEW. 

GET,VALX. 

SUI,377777. 
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If a VALIDUs file already exists on the system, it will be necessary, at this point, to enter the 
following:! 

Under DSD: 

IDLEFAMILY,xx. where xx is the EST ordinal of the device to be idled. 

When the user count is zero (idle family situation), the IDLEFAMILY command must be entered 
again so that the system will accept the ISF control statement. 

Under DSD: 

IDLEFAMILYpcx. 

Under DIS: 

ISF(R=VALIDUs). 

PURGE(VALIDUs,VALINDs). 

DEFINE,VALIDUs. 

DEFINE,VALINDs. 

COPY,VALNEW,VALIDUs,V. 

COPY,VALX,VALINDs,V. 

RETURN,VALIDUs,VALINDs. 

ISF. 

Example 5: 

Example 5 is an update at the console with the U,accnumb format. The first two user numbers entered 
via the previous creates have their passwords changed. 

X.MODVAL. 

K.n. 

K.U,USER201 

K.PW=ENTER1 

K.END 

K.U,USER202 

K.PW=ENTER2 

K.END 

K.END. 



f Before ISF(R=VALIDUs) can be entered, the system must be emptied of all executing jobs. This can be 
a time-consuming task. Refer to the NOS Operator's Guide for more information about the 
IDLEFAMILY command. 
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Example 6: 

In example 6, the previous parameters are entered at the console with the / format. 

X.MODVAL. 

K.n. 

K./USER201,PW=ENTER1 

K./USER202,PW=ENTER2 

K.END 

K.END. 
Example 7: 

In example 7, the previous update is entered by means of batch input. First, the direct access permanent 
files VALIDUs and VALINDs are copied to permanent files (direct or indirect) that can be accessed by 
the batch input and used in the MODVAL control statement. Before this is done at the console as 
follows, an idle family situation must be created and the ISF(R=VALIDUs) control statement must be 
entered. Refer to the DSD command, IDLEFAMILY, in the NOS Operator's Guide, 

X.DIS. 

SUI,377777. 

ATTACH(VALIDUs, VALINDs) 

COPY(VALIDUs,VAL) 

COPY(VALINDs,VALX) 

RETURN(VALIDUs, VALINDs) 

ISF. 

USER(usernum,passwrd,family) 

SAVE(VAL,VALX) 

The batch input is: 

Job statement 

USER(usernum,passwrd,family) 

GET(VAL,VALX) 

MODVAL(OP=U,P=VAL,U=VALX) 

REPLACE(VAL,VALX) 

7/8/9 
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/USER201,PW=ENTER1 
/USER202,PW=ENTER2 
6/7/8/9 

The modified files are returned to the system at the console. The M=W in the ATTACH is needed to 
establish write permission relative to the direct access files. However, before this is done, an idle family 
situation must be created and an ISF(R=VALIDUs) control statement must be entered. Refer to the DSD 
command, IDLEFAMILY, in the NOS Operator's Guide. 

X.DIS. 

USER(usernum ,passwrd,f amily) 

GET(VAL,VALX) 

SUI,377777. 

ATTACH(VALIDUs,VALINDs/M=W) 

COPY(VAL,VALIDUs) 

COPY(VALX,VALINDs) 

RETURN(VAUDUs,VALINDs) 

ISF. 

If the OP=Z option is used, it is not necessary to provide an input file and save it under 377777. The Z 
option makes the changes directly as follows: 

X.DIS. 

MODVAL(OP=Z)/USER201, PW=ENTER1 
(one user at a time) 
Example 8: 
In example 8, a delete is done from the console only. 

X.MODVAL. 

K,n. 

K.D.USER203 

K.END. 
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Example 9: 

In example 9, reformatting of the validation file is initiated from the console. Before DIS is used, and 
statements are typed in (no K display), an idle family situation must be created and the ISF(R=VALIDUs) 
control statement must be entered. Refer to the DSD command, IDLEFAMILY, in the NOS Operator's 
Guide. The OUTPUT file will have a listing of the purged indices. 

X.DIS. 

SUI,377777. 

ATTACH(VALIDUs,VALINDs/M=W) 

MODVAL(OP=R) 

REWIND(VALIDUs,NEWVAL) 

COPY(NEWVAL,VALIDUs) 

OUT. 

RETURN(VALIDUs,VALINDs) 

ISF. 

Example 10: 

In example 10, to reformat the validation file with batch input, the direct access files have indirect 
access copies made via the console. Before this is done, an idle family situation must be created and the 
ISF(R=VALIDUs) control statement must be entered. Refer to the DSD command, IDLEFAMILY, in the 
NOS Operator's Guide. 

X.DIS. 

SUL377777. 

ATTACH(VALIDUs,VALINDs) 

COPY(VALIDUs,VAL) 

COPY(VALINDs,VALX) 

RETURN(VALIDUs,VALINDs) 

ISF. 

USER(usernum,passwrd,family) 

SAVE(VAL,VALX) 

Them, from the card reader: 

Job statement 

USER(usernum ,passwrd, f am ily) 

GET(VAL,VALX) 
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MODVAL(OP=R,P=VAL,U=VALX) 

SAVE(NEWVAL) 

REPLACE(VALX) 

6/7/8/9 

Then from the console, the following is entered after an idle family situation has been created and the 
ISF(R=VALIDUs) control statement has been entered. Refer to the DSD command, IDLEFAMILY, in the 
NOS Operator's Guide. 

X.DIS. 

USER(usernum,passwrd,family) 

GET(NEWVAL,VALX) 

SUI,377777. 

ATTACH(VALIDUs,VALINDs/M=W) 

COPY(NEWVAL,VALIDUs,V) 

COPY(VALX,VALINDs,V) 

RETURN(VALIDUs,VALINDs) 

ISF. 
Instead of the ATTACH, in which each COPY would write over an old file, it would be possible to use 

PURGE(VALIDUs,VALINDs) 

DEFINE(VALIDUs,VALINDs) 
and then copy onto the empty files. 
Example 11: 

In example 11, the validation file is returned to source code via the console. Before this is done, an idle 
family situation must be created and the ISF(R=VALIDUs) control statement must be entered. Refer to 
the DSD command, IDLEFAMILY, in the NOS Operator's Guide. 

X.DIS. 

SUI,377777. 

ATTACH(VALIDUs,VALINDs) 

MODVAL(OP=S) 

SAVE(SOURCE) 
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Later, this source code file could be used to create a new VALIDUs file with: 

GET(SOURCE) 

MODVAL(OP=C,I=SOURCE,SI) 

The SI parameter suppresses the automatic creation of the system and library user numbers. 

Example 12: 

In example 12, the validation file is returned to source code via batch. Before this is done, an idle family 
situation must be created and the ISF(R=VALIDUs) control statement must be entered. Refer to the DSD 
command, IDLEFAMILY, in the NOS Operator's Guide. 

X.DIS. 

SUI,377777. 

ATTACH(VALIDUs,VALINDs) 

COPY(VALIDUs,VAL) 

COPY(VALINDs valx) 

RETUR N(V ALIDUs,V ALINDs) 

ISF. 

USER(usernum,passwrd,family) 

SAVE(VAL,VALX) 
From the card reader: 

Job statement 

USER(usernum,passwrd,family) 

GET(VAL,VALX) 

MODVAL(OP=S, P=VAL, U=VALX) 

SAVE(SOURCE) 
From the console: 

X.DIS. 

USER(usernum,passwrd,family) 

GEltSOURCE) 

SUI,377777. 

SAVE(SOURCE) 
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Example 13: 

In example 13 a validation file from an existing system (VALIDUX from KRONOS 2.1.1, VALIDUS from 
NOS 1.0, or VALIDUZ from NOS 1.1) is converted to NOS 1.2, 1.3, or 1.4 format. The analyst first 
deadstarts the existing system and then enters the following sequence of commands at the console. 

X.DIS. 

SUK377777) 

DEFINE(SOURCE) 

MODVAL(OP=S,FA) 

DROP. 

When the validation file is successfully converted to source, any application permissions must be edited 
into the newly created source file by supplying appropriate AP directives. The analyst deadstarts a NOS 
1 system and enters the following sequence of commands at the console. However, if ISF has already 
been done, an ISF(R=VALIDUZ) control statement must first be entered. To do this an idle family must 
be created via the IDLE FAMILY command (refer to the NOS Operator's Guide). 

X.DIS. 

SUK377777) 

PURGE(VALIDUZ,VALINDZ) 

DEFINE(VALIDUZ,VALINDZ) 

ATTACHS(SOURCE) 

MODVAL(OP=C,I=SOURCE,SI,N=VALIDUZ,RP) - RP is included only if converting to NOS 1.3 or 1.4. 

(Refer to the following note if old validation file is from a KRONOS 2.1.1 system.) 

RETURN(VALIDUZ,VALINDZ) 

ISF(E=VALIDUZ) 

DROP. 



NOTE 



If the old validation file is from a KRONOS 2.1 
system, the CV parameter must be used with the 
MODVAL statement; that is, MODVAL 
(OP=C,I=SOURCE,SI,N=VALIDUZ,RP) must be 
replaced with: 

MODVAL(OP=C,I=SOURCE,CV,SI,N=VALIDUZ,RP) 



5-36 60455380 D 



If the user wants to reverse the conversion sequence (that is, starting from NOS and converting to 
KRONOS 2.1), the CV parameter should be used on the NOS MODVAL call to SOURCE to suppress NOS 
source identifiers not recognizable by KRONOS 2.1 MODVAL. After a NOS deadstart, the following 
sequence of commands should be entered. 

X.DIS 

SUK377777) 

DEFINE(SOURCE) 

MODVAL(OP=S,C V, FA) 

DROP. 
Then, the analyst should deadstart a KRONOS 2.1.1 system and enter the following commands. 

X.DIS. 

SUK377777) 

ATT ACH0N PUT=SOU RC E) 

PURGE(VALIDUX,VALINDX) 

DEFINE(VALIDUX,VALINDX) 

MODVAL(OP=C) 

DROP. 

X.ISF. 

Example 14: 

In example 14, a VALIDUs file and a VALINDs file are created when there are no VALIDUs and VALINDs 
files already present; that is, an initial VALIDUs file and an initial VALINDs file are created. 

The local file PUTIN contains input directs for three user numbers. 

/USER201,PW=ADMIT1 

/USER202,PW=ADMIT2 

/USER203,PW=ADMIT3 
The following are entered at the console. 

X.DIS. 

SUK377777) 

DEFINE, VALIDUs, VALINDs 

MODVAL(I=PUTIN,N=VALIDUs,OP=C) 

RETURN,VALIDUs, VALINDs. 

ISF. 
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SPECIAL USER NUMBERS 

User numbers whose user indices are greater than AUIMX (which is defined as 377700 8 in common deck 
COMSACC) are considered special user numbers. To protect special user numbers from unauthorized 
access and to prohibit user access to the system using special user numbers, all special user numbers are 
illegal during login or on USER statements. Permanent files may be created under the special user 
numbers only by special system jobs or through the use of the SUI control statement. (Refer to volume 1 
of the NOS Reference Manual.) 

During a MODVAL creation run, if the SI parameter is not specified on the MODVAL control statement, 
11 special user numbers are created. These include the system user number (SYSTEMX), the library user 
number (LIBRARY), the application library user number (APPLLIB), and eight special user numbers that 
are used in an MSS environment (SUBFAMi, i=0, 1,...,7). These user numbers are automatically created; 
no action by the analyst is required. The foUowing directives create these special user numbers. 

/SYSTEMX,UI=377777,AW=ALL,PW=SYSX 

/LIBRARY,UI=377776,AW=ALL,PW=LIBR 

/APPLLIB,UI=377774,AW=ALL,PW=APPL 

/SUBFAM0,UI=377760,AW=ALL,PW=SUBF0 

/SUBFAM1,UI=377761,AW=ALL,PW=SUBF1 



/SUBFAM7,UI=377767,AW=ALL,PW=SUBF7 

Permanent files cataloged under the SYSTEMX user number are validation, project profile, resource, and 
network files. Ordinary users should not be able to access this information. 

Permanent files cataloged under the LIBRARY user number are usually accessed by many users via the 
time-sharing subsystem LIB command. They can also be accessed via the OLD, GET, or ATTACH 
commands and by routine-sharing users. (Refer to the IAF Reference Manual or the NOS Time-Sharing 
User's Reference Manual for further information.) Typically, the information saved under user number 
LIBRARY consists of permanent files containing programs or text or general interest, such as application 
programs. 

Permanent files cataloged under the APPLLIB user number are application programs that are application 
usage accounted. Many users access these programs, but they are charged accordingly. All programs to 
be application usage accounted must be direct access and have execute-only mode. 

Permanent files can be saved under the LIBRARY or APPLLIB user number only by first setting the 
LIBRARY or APPLLIB user index at the console with the SUI control statement. The input at the 
console is as follows: 

X.DIS. X.DIS 

SUK377776) (for LIBRARY) or SUI(377774) (for APPLLIB) 

The files to be made permanent can now be saved or defined. Since the only method to access files 
cataloged under these user numbers is with the alternate user access mechanism, the files should be 
cataloged with the appropriate permanent file category, passwords, and permit information to allow the 
desired alternate user access to the file. 
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Permanent files cataloged under the SUBFAMi, i=0, 1,...,7, user numbers are used during MSS processing 
as discussed in section 3. Installations that do not plan to redo a MODVAL creation run should add these 
user numbers manually. 



NOTE 



User indexes 377775 and 377760 through 377767 
are used for special purposes in the permanent file 
system. Because of this, PFDUMP will dump only 
certain specific files on these user indexes. 
Therefore, installations should not attempt to 
save files on these user indexes. 
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USER ACCOUNTING 

The special system file PROFILaf contains the information required to control a user's accounting and 
access to the system. This access is controlled not only by charge numbers and project numbers but also 
by time in, time out, expiration for charge and project numbers, accumulated SRUs, and up to eight 
accumulated resources defined by the installation.tt In addition, all exercise of this access by individual 
users is written by the system to the accounting dayfile, thereby affording the customer a time-log as a 
basis for his account billing.' For the time-sharing user, entries in the PROFILa file are updated at full 
logout or when the user's recovery file entry is dropped if the recovery time limit has expired. 

PROFILa affords three levels of job accounting. 

Charge Number This is the primary division of the customer's job structure. It is a 1- to 

10-character billing identifier. Charge numbers can only be entered onto 
PROFILa by the analyst in a system origin job or by a special accounting user, 
and their associated parameters may be changed according to the hierarchy 
of access described later in this section. 

Project Number This is an optional second level division of the charge number. It is a 1- to 

20-eharaeter identifier of a particular company project. The project number 
can be followed by time-access parameters to this project. 

Users who have been declared master users can enter and change project 
numbers and their associated parameters. 

User Number The third level is a one- to seven-character identifier of the individual user 

who is allowed access to a designated company project. This is the same user 
number that VALIDUs furnishes to verify system access refer to User 
Validation (VALIDUs— Special System file). 

User numbers are entered and deleted by the master user. A user can be 
validated for more than one project in the same charge category or in 
different ones. 

Although charge, project, and user numbers can be entered by the analyst at the console, practical 
dictates of an industrial situation usually require the analyst to create only a shell of the PROFILa file; 
that is, he enters just the charge numbers and the associated master users. This relatively constant 
information is furnished by the customer. Following this, the master users will update the PROFILa file 
with the projects and users that are under their direct cognizance. Then, if a user's validation for system 
access includes bit 7 of the access word being clear (AW=CCNR, MODVAL Input Directive section), this 
user must enter valid charge and project numbers. 



tin this manual, the user validation and accounting files are referred to as VALIDUs, VALINDs, and 
PROFILa. Refer to table 5-1 for a list of file names that correspond to the appropriate operating 
system levels, 
tf Limit and accumulation fields for these eight installation-defined resources have been reserved in 
PROFILa and are checked for exhaustion of the corresponding resource by routine CHARGE. 
However, the system provides no facility to dynamically update the accumulation fields as these 
resources are being used. 
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There are three classifications of access and modification to PROFILa: 

• System origin jobs. 

• Special accounting users (CSAP set in the user access validation word). 

• Master users. 

These classes are listed in the order of the capability they provide. System origin jobs have complete 
access to PROFILa, with no restrictions regarding PROFILE options and directives. Special accounting 
users from nonsystem origin jobs have full capabilities on update and inquire runs but may not perform 
create, list, source, or reformat runs. Master users from nonsystem origin jobs may not change any 
charge number entry parameters (such as SRU multiplier indices) or installation-related project number 
entry parameters (such as, installation accumulators or project expiration date). A master user may 
alter values pertaining only to charge numbers for which that user is the defined master user. 

This two-stage structuring of a PROFILa file is illustrated in figure 5-5. 



PROFILa PROJECT PROFILE MANAGER 

The program PROFILE uses the special system file supervisor (SFS) to create and manage the project 
profile file, PROFILa. Creation of PROFILa can only be done from the console via a system origin job 
(refer to PROFILE Console Input). Access and modification of an existing PROFILa file can be done 
from console, card reader (refer to PROFILE Batch Input), or from a time-sharing terminal (refer to 
PROFILE Execution From A Terminal), depending on the option. In all cases, options are called into 
execution with the PROFILE control statement. The format of the statement is 

PROFILE( Pl ,p 2 ,...,p n ) 
where the pj's are the identifications used in defining project profile operations and files. 



Analyst (System Origin Job) Identifications 

Identification Description 



O p= C Create option. Input directives are processed so as to 

create a new PROFILa file. Directives are entered either 
through the K display or input file. Because this option 
defines a new project file, it must be previously undefined. 
This is the only option which does not require an existing 
project file containing at least one charge number. 

0P=K K-display option. All other options (multiple OP 

specifications) are cleared and instructions must be entered 
via the K display. 
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Identification 



OP=R 



OP=S 

FM=family 

S=filenam 

OP=L,LO=F 

OP=L,LO=C 

OP=L,LO=P 



Description 

For a system origin job, if no parameters are specified and 
the call statement is 

PROFILE. 

the K option is automatically selected. In all other cases, 
OP=U is the default. 

R indicates a restructure run that rebuilds a copy of the 
current PROFILa file, discarding any deleted entries and 
reconstructing the directory to reduce file access. The 
existing PROFILa file is replaced with this restructured 
file. OP=R must not be specified if the PROFILa file is 
attached to any job or is in fast-attach status. Refer to 
the ISF control statement, section 7, for information on 
fast-attach files. 

S indicates a source run that returns the PROFILa file to 
source format (directive images) and places this source 
code on the source file (either S=source or SOURCE). This 
source file is used as the input for a later create or update. 

Name of the family the user wishes PROFILE to access. 
This option can only be specified from a system origin job. 

File to receive PROFILa source data for the option OP=S. 
Default is SOURCE. 

Produces a full listing of the whole PROFILa file; figure 
5-6 is an example. 

Produces a listing of charge numbers only for the whole 
PROFILa file; figure 5-7 is an example. 

Produces a complete charge number and project number 
listing for the whole PROFILa file; figure 5-8 is an example. 
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I 



Analyst creates 
the shell of 
charge numbers, 
with associated 
master users and 
SRU multipliers 
with a system 
origin job. 



{CHARGE NUMBER ONE 
MASTER USER ONE 
SRU MULTIPLIERS 



-\ 



{ 



PROJECT A 

TIME IN 
TIME OUT 
PROJECT B 
TIME IN 
TIME OUT 

USER01 
USER02 
USER03 



CHARGE NUMBER TWO 
MASTER USER TWO 
SRU MULTIPLIERS 



MASTER USER ONE 
supplies project numbers, 
limits, and user numbers 
to operate under 
CHARGE NUMBER ONE. 
This is done with an 
update run. 



PROJECT X 
SRU LIMITS 
PROJECT Y 
TIME IN 
TIME OUT 
SRU LIMITS 
PROJECT Z 



USER11 
USER12 
USER13 
USER01 



>-*■ 



MASTER USER TWO 
supplies project numbers, 
limits, and user numbers 
to operate under 
CHARGE NUMBER TWO. 
This is done with an 
update run. 



o 



O 



Figure 5-5. Representative Structure of a PROFILa File 



PROFILB FULL FILE LIST OF FULL FILE. PAGE 1 

CHARGE NUMBER 78/04/20. 15.38.39. 

1. 0319 

CONTROLS FOR CHARGE NUMBER 0319 

CREATION DATE 76/09/23. EXPIRATION DATE UNDEFINED 

ENTRY -ACTIVE- PROJECT COUNT = 3 

MU = MANAGER PCL = (NO LIMIT) 

(NO LIMIT) IR1 = 77B 

(NO LIMIT) IR3 = 77B 

(NO LIMIT) IR5 = 77B 

(NO LIMIT) IR7 = 77B 

(NO LIMIT) 

( 1.000) M2 = 74B 

( 0.0 06) M4 - 7 7B 

( 0.000) 

CONTROLS FOR PROJECT NUMBER 69X37 



ISL 


= 77B 


IR2 


= 77B 


IR4 


= 77B 


IR6 


= 77B 


IR8 


= 77B 


Ml 


= 77B 


M3 


= 6B 


AD 


= 77B 



(NO 
(NO 
(NO 
(NO 


LIMIT) 
LIMIT) 
LIMIT) 
LIMIT) 


( 
( 


0.143) 
0.003) 



CREATION DATE 


77/10 


/27. 


LAST 




CHANGE DATE 77/10/27. 


1 A C X 


mr\ATcr hatc 


-7 


1 nil 


/ n -l 


1 ACT 




lOnATC TTUC 11 11 lO 


i_n -j I 


>j r wn 


1_ L//"\ 1 L_ 


1 u 


U T 


1 u J . 


L.A1 J 1 




L/runiL i iriL s.±.jr.i.o. 


ENTRY 


"ACTIVE- 








EXPIRATION DATE UNDEFINED 


TI = 


0000 








TO 


= 


0000 


ISV = 


77B 


(NO 


LIMIT) 








SML = 


(NO 


LIMIT) 








SMA 


= 


331 


SIL = 


(NO 


LIMIT) 








SIA 


— 


331 


LRl = 


(NO 


LIMIT) 








AR1 


- 





LR2 = 


(NO 


LIMIT) 








AR2 


— 





LR3 = 


(NO 


LIMIT) 








AR3 


- 





LR4 = 


(NO 


LIMIT) 








AR4 


- 





LR5 = 


(NO 


LIMIT) 








AR5 


— 





LR6 = 


(NO 


LIMIT) 








AR6 


- 





LR7 = 


(NO 


LIMIT) 








AR7 


— 





LR8 = 


(NO 


LIMIT) 








AR8 


— 






CONTROLS FOR PROJECT NUMBER 693N155 

CREATION DATE 76/09/23. LAST CHANGE DATE UNDEFINED 

LAST UPDATE DATE UNDEFINED LAST UPDATE TIME UNDEFINED 

ENTRY -ACTIVE" EXPIRATION DATE UNDEFINED 

TI = 0000 TO = 0000 



LR8 = (NO LIMIT) AR8 = 

CONTROLS FOR PROJECT NUMBER 693N156 

CREATION DATE 76/09/23. LAST CHANGE DATE UNDEFINED 

LAST UPDATE DATE 77/10/25. LAST UPDATE TIME 10.54.31. 

ENTRY -ACTIVE" EXPIRATION DATE UNDEFINED 

TI = 0000 TO = 0000 

LR8 = (NO LIMIT) AR8 = 
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PROFILB CHARGE NUMBER LIST 
CHARGE NUMBER 



OF FULL FILE 
MASTER USER 



PAGE 1 
78/04/20. 15.39.49. 



1. 


0319 


2. 


042A 


3. 


0CF0 


4. 


05QP 


5. 


12YY 


6. 


23HJ79 


7. 


0560 


8. 


0561 


9. 


0580 


10. 


0593 


11. 


0594 


12. 


0595 



MANAGER 
MANAGER 
MANAGER 
MANAGER 
MANAGER 
MANAGER 
MANAGER 
MANAGER 
MANAGER 
MANAGER 
MANAGER 
MANAGER 



Figure 5-7. Full File Charge Number List (OP=L,LO=C) 



PROFILB PROJECT NUMBER LIST OF FULL FILE. 
CHARGE NUMBER MASTER USER 

1. 0319 MANAGER 

VALIDATED PROJECT NUMBERS ARE- 
69X37 693N155 

693N156 

2. 0411 MANAGER 

VALIDATED PROJECT NUMBERS ARE- 
48334 

3. 042A MANAGER 

VALIDATED PROJECT NUMBERS ARE- 
0007520 

4. 05QP MANAGER 

VALIDATED PROJECT NUMBERS ARE- 
C07108 OB25802 

5. 12YY MANAGER 

VALIDATED PROJECT NUMBERS ARE- 
5053P01 

6. 23HJ79 MANAGER 

VALIDATED PROJECT NUMBERS ARE- 
0E00356 0E00361 

0E00377 05527520 

5076M52 
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Figure 5-8. Full File Project Number List (OP=L,LO=P) 
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Analyst and Master User Identifications 

Identification 



Description 



CV 



I=filenam 

L=filenam 
P=filenam 
OP=U 

OP=T 
OP=I,CN=chargenum. 

OP=I,CN=chargenum,PN=projectnum. 

OP=L,LO=FM 
OP=L,LO=CM 

OP=L,LO=PM 

OP=L 



Redefines directives to process NOS 1.0 or 1.1 input or to 
build a source file with NOS 1.0/1.1 directives from NOS 
1.2, 1.3, or 1.4 PROFILa. This parameter is meaningful 
with OP=C, R, U, T, and S. 

CV with OP=C Assumes format of input directives 
or OP=U is NOS 1.0 or 1.1. Obsolete direc- 
or OP=T tives are ignored. 

CV with OP=S Assumes format of source directives 
to be generated is NOS 1.0 or 1.1. 
Generation of directives not perti- 
nent to NOS 1.0 or 1.1 is suppressed. 

OP=C and OP=S can be used only from a system origin job. 

File that contains input data for a create (OP=C) and an 
update (OP=U); default is INPUT. 

File to receive output listings; default is OUTPUT. 

Project profile file; default is PRO FILa. 

Updates the project profile file with directives supplied by 
the input file. U is the default option for a nonsystem 
origin job or a system origin job where at least one 
parameter is specified on the PROFILE control statement. 

Time-sharing update. Processing is the same as OP=U but 
preliminary instructions are suppressed at the terminal. 

Charge number inquire. All project numbers valid for 
charge number CN are written to the output file; figure 5-9 
is an example. 

Project number inquire. The control values and all valid 
user numbers for project number projectnum are written to 
the output file; figure 5-10 is an example. 

Full list of everything accessible on the PROFILa file by 
the master user; a sample listing is given in figure 5-11. 

Charge number list of all charge numbers accessible on the 
PROFILa file by the master user; a sample listing is given 
in figure 5-12. 

Project number list of all project numbers accessible on the 
PROFILa file by the master user; a sample listing is given 
in figure 5-13. 

Default is LO=F when the list option is called from a 
system origin job. The default is LO=FM if the job is not 
system origin. 
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/ 


CONTROLS FOR CHARGE NUMBER 


D319 




■■ ■ > 




CREATION DATE 


78/01/03. 




EXPIRATION DATE UNDEFINED 




ENTRY -ACTIVE- 






PROJECT COUNT = 2 




MU = MANAGER 






PCL 


= 


(NO LIMIT) 




ISL = 77B 


(NO LIMIT) 




IR1 


= 


77B (NO LIMIT) 




IR2 = 77B 


(NO LIMIT) 




1R3 


= 


77B (NO LIMIT) 




IR4 = 77B 


(NO LIMIT) 




IR5 


= 


77B (NO LIMIT) 




IR6 = 77B 


(NO LIMIT) 




IR7 


= 


77B (NO LIMIT) 




IR8 = 77B 


(NO LIMIT) 












VALIDATED PROJECT NUMBERS 


ARE- 








v 


MISCELLANEOUS 




69X37 




— -■ -* 



Figure 5-9. Charge number Only List (OP=I,CN=xxxx) 



CONTROLS FOR PROJECT NUMBER MISCELLANEOUS 

CREATION DATE 78/04/20. LAST CHANGE DATE 78/04/20. 

LAST UPDATE DATE UNDEFINED LAST UPDATE TIME UNDEFINED 

ENTRY -ACTIVE- EXPIRATION DATE UNDEFINED 

TI = 0000 TO = 0000 

ISV = 77B (NO LIMIT) 

SML = (NO LIMIT) SMA = 

SIL = (NO LIMIT) SIA = 

LR1 = (NO LIMIT) AR1 = 

LR2 = (NO LIMIT) AR2 = 

LR3 = (NO LIMIT) AR3 = 

LR4 = (NO LIMIT) AR<+ = 

LR5 = (NO LIMIT) AR5 = 

LR6 = (NO LIMIT) AR6 = 

LR7 = (NO LIMIT) AR7 = 

LR8 = (NO LIMIT) AR8 = 

USER NUMBERS VALID TO USE MISCELLANEOUS 

EJHA022 FARKUL NOTSLAR LAEMTAO 



Figure 5-10. Project Number List (OP=I,CN=xxxx,PN=PROJ02) 
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PROFILB FULL FILE LIST 
CHARGE NUMBER 



OF MASTER USER 



MANAGER PAGE 1 
78/04/20 . 14.02.53, 



0319 

CONTROLS FOR CHARGE NUMBER 0319 



CREATION DATE 
ENTRY -ACTIVE 1 
MU = MANAGER 



78/01/03 



ISL 
IR2 
IR4 
IR6 
IRS 



77B 
77B 
77B 
77B 
77B 



(NO 
(NO 
(NO 
(NO 
(NO 



LIMIT) 
LIMIT) 
LIMIT) 
LIMIT) 
LIMIT) 



EXPIRATION DATE UNDEFINED 

PROJECT COUNT = 2 

PCL = (NO LIMIT) 

IR1 = 77B 

IR3 = 77B 

IR5 = 77B 

IR7 = 77B 



(NO LIMIT) 

(NO LIMIT) 

(NO LIMIT) 

(NO LIMIT) 



CONTROLS FOR PROJECT NUMBER MISCELLANEOUS 



CREATION DATE 
LAST UPDATE DATE 
ENTRY -ACTIVE- 



7 8/04/20, 
UNDEFINED 



1 i : 


= 000( 


) 


ISV : 


-- 77B 




SML : 


= (NO 


LIMIT) 


SIL : 


= (NO 


LIMIT) 


LR1 : 


= (NO 


LIMIT) 


LR2 : 


= (NO 


LIMIT) 


LR3 : 


= (NO 


LIMIT) 


LR4 : 


: (NO 


LIMIT) 


LR5 : 


= (NO 


LIMIT) 


LR6 : 


= (NO 


LIMIT) 


LR7 : 


-- (NO 


LIMIT) 


LR8 : 


= (NO 


LIMIT) 



(NO LIMIT) 



LAST 


CHANGE DATE 7 8/04/20. 


LAST 


UPDATE TIME UNDEFINED 


EXPIRATION DATE UNDEFINED 


TO = 


0000 


SMA = 





SIA = 





AR1 = 





AR2 = 





AR3 = 





AR4 = 





AR5 = 





AR6 = 





AR7 = 





AR8 = 






USER NUMBERS VALID TO USE MISCELLANEOUS 
EJHA022 FARKUL NOTSLAR LAEMTAO 



CONTROLS FOR PROJECT NUMBER 69X37 



CREATION DATE 
LAST UPDATE DATE 



78/01/03. 
78/04/20. 



ENTRY 

TI = 

ISV = 

SML = 

SIL = 

LR1 = 

LR2 = 

LR3 = 

LR4 = 

LR5 = 

LR6 = 

LR7 = 

LR8 = 

USER 
STUDENT 
EJHA022 



-ACTIVE 1 

0000 

77B 



LAST CHANGE DATE 
LAST UPDATE TIME 
EXPIRATION DATE 
TO =0 000 



78/03/20. 
13.52.32. 

UNDEFINED 



(NO LIMIT) 



(NO 
(NO 
(NO 
(NO 
(NO 
(NO 
(NO 
(NO 
(NO 
(NO 



LIMIT) 
LIMIT) 
LIMIT) 
LIMIT) 
LIMIT) 
LIMIT) 
LIMIT) 
LIMIT) 
LIMIT) 
LIMIT) 



SMA 
SIA 
AR1 
AR2 
AR3 
AR4 
AR5 
AR6 
AR7 
AR8 



NUMBERS VALID TO USE 69X37 
BLONDIE TONTO INSTALL 
FARKUL NOTSLAR LAEMTAO 



31370 

31370 



















DAVINCI 
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Figure 5-11. Master User Full File List (OP=L,LO=FM) 
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PROFILB CHARGE NUMBER LIST OF MASTER USER MANAGER PAGE 1 
CHARGE NUMBER 78/04/20. 14.03.42. 

1. 0319 

2. 042A 

3. OCFO 

4. 05QP 

5. 12YY 

6. 23HJ79 



Figure 5-12. Master Charge Number List (OP=L,LO=CM) 



PROFILB PROJECT NUMBER LIST OF MASTER USER MANAGER PAGE 1 
CHARGE NUMBER 78/04/20. 14.04.26. 

1. 0319 

VALIDATED PROJECT NUMBERS ARE- 
MISCELLANEOUS 69X37 



Figure 5-13. Master User Project Number List (OP=L, LO=PM) 
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INPUT DIRECTIVES 

Directives are available as input to PROFILE to add or update information concerning each charge 
number. The input stream for a PROFILE create (OP=C) or update (OP=U) is divided into two types of 
entries, charge number entries and directives. 

A charge number entry must begin with a / in column 1 or with the CN= or ACN= directive. The 1 to 10 
characters following the / or directive are the charge number name. This name is terminated by a 
separator. Separators consist of all special characters (except /, +, -, *, and :), end-of-line, and 
end-of-card. Additional directives may immediately follow the separator. 

The directives associated with a particular charge number must follow the charge number entry. All 
directives following a charge number entry apply to that charge number until another charge number 
entry occurs. A particular charge number can appear only once in an input stream on a create run. 

The directives applying to a particular charge number are further divided into master user and SRU 
multipliers, project number, and associated project number entries. The project number entry contains 
the data identifiers that establish the control values for this project and the list of user numbers that 
may access this project. The occurrence of duplicate project numbers under the same charge number 
entry is not allowed on a create run. 

Figure 5-14 illustrates a typical input stream. 

All directives following a charge number entry are in free format to column 72. Directives cannot be 
split between cards or lines. Blanks are ignored. 

The format of a directive is: 

ident=data 

ident A two- or three-character designation of the limiting parameter. 

data Value applied to the project under which this directive appears. 

The following directives are available for PROFILE input. 

Identifier Description 



MU 



Master user number which has the ability to update, inquire, and make 
listings for the projects entered under the same charge number as this 
master user. 

This master user number must be specified on the USER statement for 
batch input (refer to PROFILE Batch Input) or when logging in (for 
time-sharing, refer to PROFILE Execution From A Terminal) in order 
for the master user to exercise the project-oriented privileges specified. 

The master user number is one- to seven-alphanumeric characters. 

There can be only one master user per charge number. 
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Charge Number 

r 



Master User - - 
Project Number 



Charge 
Number ^ 
Entry 



Charge Number 



- /CHNUMBER01 

- MU=USEAAA 
-- PN=PROJECTNUMBER001 

TI=1200 

TO- 1700 

Project 
Number 

Entry AUN=USERA11 

AUN=USERA12 

Project Number -- PN=PROJECTNUMBER002 
f 

TI=0800 

TO=1200 

AUN=USERA21 
AUN=USERA22 
AUN=USERA23 

- CN=CHNUMBER02 

- MU=USERBBB 



Project 
Number 
Entry 



Charge 
Number ^ 
Entry 



Master User - - 

Project Number -- PN=PROJECTNUMBER011 

TI=0000 

TO0800 



Project 
Number 
Entry 



AUN=USERB11 
AUN=USERB12 



Figure 5-14. Typical Input Stream for Use with PROFILE 
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Identifier 



Ml 



M2 



M3 



M4 



AD 



PN 



Description 

Index for the SRU multiplier to weight calculated system resources used 
against those not directly measurable for this charge number. This may 
be one or two numeric digits. A radix may follow to indicate decimal 
(D) or octal (B). If the radix is omitted, decimal is assumed. The 
maximum and default value of 77g gives system default. Ml can only 
be set from a system origin job. (Refer to Multiplier Index Values and 
Actual Multiplier Values for more information on the usage of this 
parameter.) 

Index for the SRU multiplier to weight input/output usage for this 
charge number. This may be one or two numeric digits. A radix may 
follow to indicate decimal (D) or octal (B). If the radix is omitted, 
decimal is assumed. The maximum and default value of 77g gives 
system default. M2 can only be set from a system origin job. (Refer to 
Multiplier Index Values and Actual Multiplier Values for more 
information on the usage of this parameter.) 

Index for the SRU multiplier to weight central memory field length 
usage for this charge number. This may be one or two numeric digits. 
A radix may follow to indicate decimal (D) or octal (B). If the radix is 
omitted, decimal is assumed. The maximum and default value of 77g 
gives system default. M3 can only be set from a system origin job. 
(Refer to Multiplier Index Values and Actual Multiplier Values for more 
information on the usage of this parameter.) 

Index for the SRU multiplier to weight extended core field length usage 
for this charge number. This may be one or two numeric digits. A radix 
may follow to indicate decimal (D) or octal (B). If the radix is omitted, 
decimal is assumed. The maximum and default value of 77g gives 
system default. M4 can only be set from a system origin job. (Refer to 
Multiplier Index Values and Actual Multiplier Values for more 
information on the usage of this parameter.) 

Index for the SRU constant used to charge for resources not directly 
measurable by the system for this charge number. This may be one or 
two numeric digits. A radix may follow to indicate decimal (D) or octal 
(B). If the radix is omitted, decimal is assumed. The maximum and 
default value of 77g gives system default. AD can only be set from a 
system origin job. (Refer to Multiplier Index Values and Actual 
Multiplier Values for more information on the usage of this parameter.) 

Project number. This is a 1- to 20-character alphanumeric designation 
of a particular customer activity. The specified project number must 
exist and be active unless OP=C or CV is also specified; this identifier 
would then be interpreted as APN. This entry can be specified by a 
master user. 
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Identifier 



AUN 



DUN 



TI 



TO 



LRn 



ARnt 



DCN 



DPN 



Description 

Add user number. A one- to seven-alphanumeric identification of the 
individual or individuals who will have access to the project or projects 
under which this user number is entered. It is also the identification 
used by VALIDUs to establish system access (MODVAL Validation File 
Manager). Under NOS, all f iles are cataloged by user number (section 1). 

A maximum of 4095 user numbers can be validated for a single charge 
and project number. 

If no user numbers are specified for a project, then all user numbers are 
allowed to use it. This entry can be specified by a master user. 

Delete user number. Deletes the user number from the list of those 
who may access the project number. This entry can be specified by a 
master user. 

Time of day before which the validated user cannot use this project 
number. This is expressed in four-digit military time notation. A radix 
may follow to indicate decimal (D) or octal (B). If the radix is omitted, 
decimal is assumed. Maximum value is 2400. This entry can be 
specified by a master user. 

Time of day after which the validated user cannot use this project 
number. This is expressed in four-digit military time notation. A radix 
may follow to indicate decimal (D) or octal (B). If the radix is omitted, 
decimal is assumed. Maximum value is 2400; however, TI=TO implies no 
restriction. This entry can be specified by a master user. 

Installation limit register n, where n = 1,2,. ..,8. For each n, LRn 
specifies the maximum number of resource units (as defined by the 
installation) the project can use. However, a value of zero implies no 
restriction. 

For installation accumulator n, where n = 1,2,. ..,8. For each n, ARn 
specifies the current number of resource units the project has used. 
When ARn surpasses LRn, the project is not available to users until 
either the limit or accumulator is respecified. 

Deactivate charge number. This directive does not destroy the 
specified charge number entry but sets its status such that the entry 
and all project entries under it are not available to users. PROFILE 
reformat runs purge all deactivated entries. This entry is not legal 
when OP=C is specified. 

Deactivate project number. This directive does not destroy the 
specified project number entry but sets its status such that the entry is 
not available to users. PROFILE reformat runs purge all deactivated 
entries. This entry is not legal when OP=C is specified. This entry can 
be specified by a master user. 



t The system does not update these fields. Each installation must provide this capability, if desired. 



5-52 



60455380 G 



Identifier 



CN 



ACN 



APN 



PCL 



CEX 



Description 

Charge number. This is a 1- to 10-eharacter alphanumeric designation. 
This directive performs the same function as the /. The specified 
charge number must exist and be active unless OP=C or CV is also 
specified; the identifier would then be interpreted as ACN. This entry 
can be specified by a master user. 

Add or activate charge number. A charge number is created if it does 
not already exist or is activated if it is inactive. However, the charge 
number must not exist when OP=C is specified. 

Add or activate project number. A project number is created if it does 
not already exist or is activated if it is inactive. However, the project 
number must not exist when OP=C is specified. This entry can be 
specified by a master user. 

Project count limit. Maximum number of projects allowed under this 
charge number. 

Charge number expiration date. When the current date surpasses the 
expiration date, the charge number entry and all project entries under it 
are not available to users. However, a value of zero implies no 
restriction. 



ISL 
IRn 

PEX 

ISV 

SML 

SMA 



Index for default value of the SRU installation limit register. 

Index for default value of installation limit register n, where n = 
1,2,...,8. 

Project number expiration date expressed as yymmdd. When the 
current date surpasses the expiration date, the project number is not 
available to users. However, a value of zero implies no restriction. 
This entry can be specified by a master user. 

Index for SRU validation limit. It indicates the maximum SRU 
accumulation for any job using this charge/project number. This entry 
can be specified by a master user. 

SRU master user limit register. This value specifies the maximum 
number of accumulated SRUs the project may use as controlled by the 
master user. However, a value of zero implies no restriction. This 
entry can be specified by a master user. 

SRU master user accumulator. This value specifies the current number 
of accumulated SRUs the project has used. This accumulator is updated 
at the end of a job or terminal session and/or when a second or 
subsequent CHARGE statement is issued. When the SMA value 
surpasses the SML value, the project is not available to users until 
either the limit or accumulator is respecified. This entry can be 
specified by a master user. 
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Identifier Description 

SIL SRU installation limit register. This value specifies the maximum 

number of accumulated SRUs the project may use as controlled by the 
installation. However, a value of zero implies no restriction. 

SIA SRU installation accumulator. This value specifies the current number 

of accumulated SRUs the project has used. This accumulator is updated 
at the end of a job or terminal session and/or when a second or 
subsequent CHARGE statement is issued. When the SIA value surpasses 
the SIL value, the project is not available to users until either the limit 
or accumulator is respecified. 



PROFILE CONSOLE INPUT 

A PROFILa file can only be created by calling PROFILE from the console (system origin job). Likewise 
an existing PROFILa file can be restructured, returned to source, or read to an output file as a full-file 
listing only from the console. The remaining operations (update, inquire, and master user listings) can be 
executed from console, batch (PROFILE Batch Input), or a terminal (PROFILE Execution from a 
Terminal). 

A new PROFILa file can be created via the console by means of the DIS display. A preestablished input 
file of control values is called and the PROFILE command with OP=C is entered. The following example 
given an input file (INPUT) with control values for structuring a new PROFILa file, is a create run from 
the console. 

X.DIS. 

SUK377777) 

GET(INPUT) 

PROFILE(OP=C) 

The K display can be used only for an update. With the K option, directives are entered directly via the 
console instead of from an input file. If directives are entered for an existing charge and project 
number, the control values are changed according to the directive. 

The K display is called with: 
X.PROFILE. 

The B display will indicate the control point to which PROFILE is located. A flashing message on that 
line will be: 

REQUEST K DISPLAY 

The analyst types 

K,n. 
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reader input. The following is an example of a batch update in which master user MASTRl'addfe a 



where n is the control point number for PROFILE. This brings the K display for PROFILa to the left 
screen (figure 5-15). The analyst is now ready to create or update. The following example illustrates an 
update input stream to follow the above. 

K./CHARGNUM1 (The / is used when PROFILE is updating an existing charge number.) 

K.MU=MUSE1 

K.END 

K./CHARJNUM2 

K.MU=MUSE2 

K.END 

K.STOP 

PROFILE BATCH INPUT 

A master user can initiate an update, inquire, or listing of the proieets under his eharoe n.jmw *„•* ™*a 
reader input. The following is an example of a batch updat 
time-in (TI) and a time-out (TO) to one of his projects (PROJ2). 

JOBUPDA. 

USER(MASTRl) 

PROFILE{OP=U) 

7/8/9 

/CHARJNUM1 

PN=PROJ2 

TI=1400 

TO=1800 

6/7/8/9 



PROFILE EXECUTION FROM A TERMINAL 

A master user can initiate an update, inquire, or listing of the projects under his charge number from a 
time-sharing terminal. To do this he must have his master user status validated at login. After this 
validation is affirmed, the master user must enter the batch subsystem or use the IAF X command in 
order to use the PROFILE control statement. 
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CREATED 



PROFILB 
76/09/23. 



LAST MOD 73/02/01 



END - UPDATE PROFILE FILE AND TERMINATE CURRENT CHARGE 

DROP - DROP DIRECTIVES ENTERED SINCE CHARGE OR PROJECT 

STOP - END PROCESSING. 

/ OR CN= CHARGE NUMBER, ACTIVE CHARGE MUST EXIST. 

ACN= ADD OR ACTIVATE CHARGE. DCN = DEACTIVATE CHARGE. 

PN= PROJECT NUMBER, ACTIVE PROJECT MUST EXIST. 

APN= ADD OR ACTIVATE PROJECT. DPN= DEACTIVATE PROJECT 



CHARGE NUMBER 



1230 



CREATION DATE 


76/09/23. 


EXPIRATION 


DATE 


UNDEFINED 


ENTRY 


-ACTIVE- 






PROJECT COUNT : 


= 3 


MU = 


MANAGER 






PCL = (NO 


LIMIT) 


Ml = 


77B 


C 


1.000) 


M2 = 74B 




( 0.143) 


M3 = 


68 


C 


0.006) 


m - 77B 




( 0.003) 


AD = 


77B 


( 


0.000) 


ISL = 77B 




(NO LIMIT) 


IRl = 


77B 


(NO 


LIMIT) 


IR2 - 77B 




(NO LIMIT) 


IR3 = 


77B 


(NO 


LIMIT) 


IR4 = 77B 




(NO LIMIT) 


IR5 = 


77B 


(NO 


LIMIT) 


IR6 = 77B 




(NO LIMIT) 


IR7 = 


77B 


(NO 


LIMIT) 


IR8 = 77B 




(NO LIMIT) 



PROJECT NUMBER 23A69 



CREATION DATE 


77/10/27. 


LAST 


CHANGE DATE 77/10/27. 


LAST 


JPDATE DATE 


78/03/31. 


LAST 


UPDATE TIME 13.17.23. 


ENTRY 


"ACTIVE" 






EXPIRATION DATE UNDEFINED 


TI = 


000( 


) 






TO = 


0000 


ISV = 


77B 


(NO 


LIMIT) 






SML = 


(NO 


LIMIT) 






SMA = 


330 


SIL = 


(NO 


LIMIT) 






SIA = 


330 


LRl = 


(NO 


LIMIT) 






ARl = 





LR2 = 


(NO 


LIMIT) 






AR2 = 





LR3 = 


(NO 


LIMIT) 






AR3 = 





LR4 = 


(NO 


LIMIT) 






AR4 = 





LR5 = 


(NO 


LIMIT) 






AR5 = 





LR6 = 


(NO 


LIMIT) 






AR6 = 





LR7 = 


(NO 


LIMIT) 






AR7 = 





LR8 r 


(NO 


LIMIT) 






AR8 = 






Figure 5-15. PROFILa K Display (Left Screen Only) 
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Update from a Terminal 

The time-sharing master user ean initiate an update by issuing the command PROFILE (OP=U). Once 
initiated, the system prints the following block of information at the terminal. 

THE FOLLOWING ARE VALID INPUT DIRECTIVES FOR 
UPDATE- 

CN OR / - CHARGE NUMBER. 

PN - PROJECT NUMBER. 

APN - ADD OR ACTIVATE PROJECT NUMBER. 

DPN - DEACTIVATE PROJECT NUMBER. 

PEX - PROJECT NUMBER EXPIRATION DATE. 

TI - TIME IN. 

TO - TIME OFF. 

ISV - SRU VALIDATION LIMIT INDEX. 

SML - SRU MASTER USER LIMIT. 

SMA - SRU MASTER USER ACCUMULATOR. 

AUN - ADD USER NUMBER. 

DUN - DELETE USER NUMBER. 

ACN - ADD OR ACTIVATE CHARGE NUMBER. 

DCN - DEACTIVATE CHARGE NUMBER. 

MU - MASTER USER NUMBER. 

PCL - PROJECT COUNT LIMIT, 

Ml - M4 - SRU MULTIPLIER INDICES. 



Only for users with 
special accounting, 
privileges. 



AD - SRU CONSTANT INDEX. 
CEX - CHARGE NUMBER EXPIRATION DATE. 
ISL - INSTALLATION SRU LIMIT INDEX. 
IR1 - IR8 - INSTALLATION LIMIT INDICES. 

SIL - SRU INSTALLATION LIMIT. 
SIA - SRU INSTALLATION ACCUMULATOR. 
LR1 - LR8 - INSTALLATION LIMIT REGISTERS. 

AR1 - AR8 - INSTALLATION ACCUMULATORS. 

A NULL LINE COMPLETES DIRECTIVE INPUT PROCESSING. 

This informative printout can be suppressed by using the control statement option OP=T instead of 
OP=U. In all other regards, the operation of T is identical to U. 

If charge and project numbers are required, the example would run as follows: 

/ENTER DIRECTIVES 

?/CHARJl 

? PN=PROJ2 

? TI=0800 

? TO=1200 

? © 

PROFILa UPDATED. 

/ 
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Inquire from a Terminal 

The master user can request information on his current charge number and its project numbers by means 
of an inquire from a terminal. To do this, the master user issues the command 

PROFILE(OP=I,CN=chargenum,PN=projectnum) 

where chargenum is his charge number and projectnum is the particular project for which he wants 
information. 

If the charge number has not been supplied, PROFILE outputs 

ENTER CHARGE NUMBER 

when it processes the command. The user must type in the appropriate charge number. If a null line is 
entered, it is treated as end-of-f ile (end processing). 

After output of the desired information or if a charge number has not been supplied in the PROFILE 
control statement, PROFILE issues 

ENTER CHARGE NUMBER 

to the terminal and waits for the user to enter the desired charge number. If a null line is entered, it is 
treated as end-of-f ile (end processing). 

If a project number has not been entered on the control statement or if a charge number has just been 
supplied in response to ENTER CHARGE NUMBER, PROFILE issues 

ENTER PROJECT NUMBER 

to the terminal and waits for the user to enter the desired project number. If a null line is entered, 
output consists of a list of valid project numbers under this charge number, and PROFILE again responds 

ENTER PROJECT NUMBER 

If a project number is entered, output consists of a list of the controls for and valid users of this project 
number. PROFILE again responds 

ENTER PROJECT NUMBER 

until a null line is entered to indicate end of processing for the current charge number. 



List from a Terminal 

The master user can request an FM, CM, or PM listing from a terminal (refer to PROFILa Project 
PROFILE Manager). Sample listings are given in figures 5-11, 5-12, and 5-13. 

As with an update and an inquire, the master user must enter the BATCH subsystem or use the 
time-sharing X command to use this option. 
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CHARGE CONTROL STATEMENT 

The system routine CHARGE provides validation of a user's charge and project number for access to 
define segments of his resources within the system. A call to CHARGE will be required for either a 
master user or a project-level user if bit 7 (AW=CCNR) in his access word is not set (MODVAL Validation 
File Manager section). Operation of the CHARGE routine is flowcharted in figure 5-16. 

If validation fails, the job is aborted and the appropriate error message is issued to the dayfile. If the 
user is at a terminal, the message is returned to the terminal. 

If validation is successful, the following events occur. 

• Accounting information is written to the accounting dayfile (refer to Account Dayfile Messages 
for message formats). 

« The accounting parameters associated with the user's charge-project number are inserted into 
the accounting formula (refer to the SRU Formula). They are used in calculating the billing unit 
until the end of job/session or until another charge-project number is entered. 

• The SRU accumulator is set to zero. The CP, MS, MT, and PF accumulators are not altered in 
any way. If the minimum charge installation option has been selected and if the accumulated 
SRUs are less than the minimum charge amount, the minimum charge value is entered into the 
account dayfile (the Resource Accounting section describes the parameters and the minimum 
charge installation option). 

The following is the ordered list of the account dayfile and user's dayfile messages issued whenever a new 
charge number is entered. These messages are not issued, however, as a result of a required CHARGE 
statement that immediately follows an initial USER statement. 

yy.mm.dd. hh.mm.ss.jobnameo. UDCO, xxxxxx.xxxKCHS. (Telex users only) 

yy.mm.dd. hh.mm.ss.jobnameo. UDCI, xxxxxx.xxxKCHS. (Telex users only) 

yy.mm.dd. hh.mm.ss.jobnameo. UDCP, xxxxxx.xxxSECS. 

yy.mm.dd. hh.mm.ss.jobnameo. UDMS, xxxxxx.xxxKUNS. 

yy.mm.dd. hh.mm.ss.jobnameo. UDMT, xxxxxx.xxxKUNS. 

yy.mm.dd. hh.mm.ss.jobnameo. UDPF, xxxxxx-xxxKUNS. 

yy.mm.dd. hh.mm.ss.jobnameo. UDAD, xxxxxx.xxxUNTS. 

yy.mm.dd. hh.mm.ss.jobnameo. ACSR, xxxxxx.xxxUNTS. 

yy.mm.dd. hh.mm.ss.jobnameo. ACCN, chargenum,projectnum. (Account dayfile only) 

Account dayfile messages are described in detail later in this section. 

The CHARGE routine is called from a terminal as a response to entering the CHARGE command or 
control statement after successfully logging in to IAF or the Time-Sharing Module. 

The CHARGE routine is called from a batch job by the appearance of the CHARGE control statement 
after a user statement. 

The format of the CHARGE control statement is: 

CHARGE(chargenum,projectnum) 

chargenum Charge number (1 to 10 alphanumeric characters). 

projectnum Project number (1 to 20 alphanumeric characters). 
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OPERATION 



UJ CHECKS ACCESS WORD 
FOR THIS USER 




CHARGE ROUTINE SEARCHES 
PROFILa FOR CHARGE AND 
PROJECT NUMBER COMBINATION 




CHECK CHARGE AND PROJECT 
NUMBERS ACTIVE 




BOTH ^-^ NO 
ACTIVE ? 



CHECK TIME OF DAY 




CHECK PROFILa FOR REMAINING 
SRU* AVAILABLE 



CHECK PROFILa FOR REMAINING 
ADDITIONAL RESOURCES 




CHECK LIST OF USERS WHO 
MAY ACCESS THIS PROJECT 




VALIDATION FAILS 



(DIAGNOSTICS) 



VALIDATION SUCCESSFUL 



USER MAY ACCESS SYSTEM WITHOUT 
ENTRY OF CHARGE OR PROJECT 
NUMBERS. THE SYSTEM DEFAULT 
ACCOUNTING PARAMETERS ARE USED. 



•IMPROPER VALIDATION. 



ILLEGAL CHARGE. (CHARGE OR 
"♦ PROJECT NUMBER DOES NOT 
EXIST). 



ILLEGAL CHARGE. (CHARGE OR 
PROJECT NUMBER INACTIVE). 



-*■ CHARGE ILLEGAL AT THIS HOUR. 




CUMULATIVE SRU LIMIT EXCEEDED. 



_», CUMULATIVE RESOURCE USAGE 
LIMIT EXCEEDED. 



MAY ACCESS ANY PROJECT UNDER HIS 
CHARGE NUMBER. 



-•» ILLEGAL CHARGE. 



USER MAY ACCESS THE DESIGNATED 
PROJECT WITHIN LIMITS ESTABLISHED. 



USER MAY ACCESS THE DESIGNATED 
PROJECT WITHIN LIMITS ESTABLISHED. 



Figure 5-16. CHARGE Routine 
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Batch Usage of CHARGE 

When a batch job is submitted, the second statement is the user statement which gives the user number 
used in validating a user for system access. Associated with this number is the access word which 
determines whether or not this user must supply charge and project numbers. If validation control 
indicates that these are required, the statement following the user statement must be a CHARGE 
statement with acceptable charge and project numbers. If additional projects and/or charges are 
referenced in the job, these references must be accomplished by use of another CHARGE statement. If 
additional user statements (new users) appear in the input, each one that identifies a user requiring job 
profile validation must be followed by a CHARGE statement with the requisite charge and project 
numbers. 



CHARGE Application at a Terminal 

When any user logs in at a terminal, the access word associated with his user number is checked to see if 
he is required to enter a charge number and a project number. If not, the teletype will print out at login: 

TERMINAL nnnn,type 

RECOVER/SYSTEM: 

The user then types in the subsystem he wishes to use and proceeds with access to resources as defined 
by his user number. 

If charge and project are required, the terminal will print out at login: 

TERMINAL nnnn,type 

RECOVER/CHARGE: 

This user will not be allowed to enter any commands (except CHARGE, LOGIN, HELLO, RECOVER, 
GOODBYE, and BYE) until he enters valid charge and project numbers. He will then be allowed access to 
that particular project under that particular charge under whatever restrictions are currently in force for 
that project. 

If later, while still logged in, this user wishes to access another project (under this charge or another) for 
which he is validated, he enters the CHARGE control statement with the appropriate charge and project 
numbers. 



USER NUMBERS AND CHARGE NUMBERS 

System access (remote/local) privileges are given to a user through the assignment of a user number and 
a password. Once a system access is attained, all billable activity is associated with a charge number. 
The system provides the central site with the flexibility of equating a charge number to a user number or 
maintaining them as separate entities. This flexibility is attained through the use of the CHARGE 
required flag (CCNR bit in the VALIDUst access word) and the availability of a charge number in the 
PRO FILaf file. Table 5-3 indicates the combinations possible and the effective billing number. 



tin this manual, the user validation and accounting files are referred to as VALIDUs, VALINDs, and 
PROFILa. Refer to table 5-1 for a list of file names that correspond to the appropriate operating 
system levels. 
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TABLE 5-3. EFFECTIVE BILLING NUMBER 



No PROFILa 
Entry 



PROFILa Entry 
Available 



Charge Number Required 



This option is not possible 
since a charge number is 
required. 

The resources used during 
job/session initialization 
(login and user validation) 
are accumulated and thus 
billed under the required 
charge number. 



Charge Number Not Required 



The user number is used as the 
billing number. 

The user number is used as the 
billing number until such time 
that the user decides to enter 
the charge number. 



RESOURCE ACCOUNTING 

The basic accounting unit for NOS is the system resource unit (SRU). The SRU is a measurement of the 
resources used by a job or a terminal session. The SRU algorithm combines measurements of the 
following resources into a single unit. 

Central memory field length 

ECS field length 

CPU time 

Mass storage usage 

Magnetic tape usage 

Permanent file usage 

The SRU calculation is dynamic; that is, each time additional amounts of the above resources are utilized 
by the job or session, the SRU value is updated. The following sections describe the algorithm for 
calculating SRU values and a detailed description of SRU components. 



SRU FORMULA 

The following formula is used by the system for SRU computation. 

SRU = M1(CP + M2 x 10 + M3(CP + IO)CM + M4(CP + IO)EC) + AD 



Parameter 



CP 



Description 

Central processor unit usage expressed in milliunits. The value of this 
parameter is determined by the following formula. 

CP = SO x CPO + SI x CP1 

CPO Time accumulated on CPU in milliseconds. 

CP1 Time accumulated on CPU 1 in milliseconds. 

S0,S1 Multipliers used to normalize CPU time when the 

system is running on a dual CPU machine. 
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Parameter Description 

10 A measure of the accumulated input/output system activity for a user. This 

parameter, expressed in milliunits, is defined by the following formula. 

10 = S2 x MS + S3 x MT + S4 x PF 

MS Mass storage activity accumulator. The components 

of this parameter are described in detail in the 10 
Increments section. 

MT Magnetic tape activity accumulator. The components 

of this parameter are described in detail in the 10 
Increments section. 

PF Permanent file activity accumulator. The components 

of this parameter are described in detail in the 10 
Increments section. 

S2,S3,S4 Multipliers used to weight MS, MT, and PF activity 

against one another. 

CM Central memory field length expressed in words/lOOOg. 

EC ECS field length expressed in words/1 OOOg. 

Ml Multiplier used to scale the overall SRU value. 

M2 Multiplier used to weight the I/O activity against CPU time, CM field length, 

and ECS field length usage. 

M3 Multipliers used to weight CM field length, CPU time, and I/O activity. 

M4 Multiplier used to weight ECS field length, CPU time, and I/O activity. 

AD Incremental adder which is applied to the SRU value during accounting 

initialization. 

The multipliers SO through S4, as weU as the default values for units of MS, MT, and PF, are installation 
options which do not change during system execution. The multipliers Ml through M4 and the adder AD 
are also installation options, but they may change once system activity has begun. The default values for 
Ml through M4 and AD are set during job or session initialization. When a charge number is entered, 
different values for Ml through M4 and AD may be specified for use in the SRU calculation (refer to 
PROFILE Console Input). These parameters are retained in PROFILa and provide the central site with 
the flexibility of varying the billing unit for selected users. 
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SRU PARAMETERS 

The common deck COMSSRU contains the definitions for the SRU multipliers and associated 
parameters. The absolute ranges for these values are also defined. To obtain a listing of COMSSRU, 
assemble CALLSYS; the default values are shown. To change any default values, modifications must be 
made in COMSSRU. 

The following paragraphs describe the SRU parameters and list the absolute ranges and default values. 
The COMSSRU name is listed along with the default value for each parameter. When a site sets SRU 
parameter default values, these values must lie within the absolute range for each parameter. 



SO and SI 

The values used for SO and SI are selected by the system at deadstart time from a list of multipliers 
defined for each type of CPU detectable by NOS. SO is the primary multiplier and is used for all single 
CPU machines. For dual CPU machines, SO is used for the first CPU (CPU 0) and SI is used for 
calculations involving the second CPU (CPU 1). For example, if a site is running a 6700, SO is assigned 
the value defined for a 6600 CPU and SI is assigned the value defined for a 6400 CPU. This allows a site 
with several systems to use different multipliers for different CPUs while using only one deadstart tape. 

It is possible for a site to transform this selection at deadstart by the use of the IPRDECK entry CPM. 
Use of this entry allows the site to select any multiplier from the list in COMSSRU, which follows, to be 
used instead of the normally selected value. One advantage of this entry is that an installation may 
charge differently for the use of a 6200 CPU or a 6400 CPU although the software cannot normally 
detect the difference. 

Description 



COMSSRU Name 


Default Value 


CP62 


1.0 


CP64 


1.0 


CP66 


1.0 


CP71 


1.0 


C171 


1.0 


C172 


1.0 


C173 


1.0 


C175 


1.0 


C176 


1.0 


ICM1 


2.0 


ICM2 


3.0 


ICM3 


4.0 


ICM4 


5.0 



6400/CYBER 72 CPU 
6400/CYBER 73 CPU 
6600/CYBER 74 CPU 
CYBER 71 CPU 
CYBER 171 CPU 
CYBER 172 CPU 
CYBER 173 CPU 
CYBER 175 CPU 
CYBER 176 CPU 

Installation 

selected CPU 

multiplier 

values 



Absolute range: 0.1 to 50.0 



S2, S3, and S4 



These multipliers are used in the calculation of the IO parameter. In addition to providing weighting 
factors, these multipliers also convert units of resource usage (MS, MT, or PF) to milliunits of IO. For 
example, if the default value for S2 is used, 300 units of MS usage result in 300 milliunits of IO. 
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COMSSRU Name Default Value (Milliunits) Description 



S2SR 1.0 MS multiplier (S2) 

S3SR 1.0 MT multiplier (S3) 

S4SR 1.0 PF multiplier (S4) 



Absolute range: 0.1 to 50.0 



Ml 



This multiplier is used as a sealing factor to increase or decrease the overall SRU value. This value may 
be changed from the system default for eaeh charge number when this charge number is entered (refer to 
PROFILE Console Input and Multiplier Index Values and Actual Multiplier Values for further information). 

COMSSRU Name Default Value Description 



M1SR 1.0 Ml multiplier 

Absolute range: 0.1 to 25.5 

M2, M3, and M4 

These multipliers provide weighting of the various terms in the SRU calculation. These values may be 
changed from the system default values for each charge number when this charge number is entered 
(refer to PROFILE Console Input and Multiplier Index Values and Actual Multiplier Values for further 
information). 

COMSSRU Name Default Value Description 

M2SR 0.100 M2 multiplier 

M3SR 0.003 M3 multiplier 

M4SR 0.0 M4 multiplier 

Absolute range: 0.001 to 1.023 



AD 

The value assigned to this parameter is applied to the SRU value during accounting initialization of a job 
or session. It thus serves as an overhead increment. This value may be changed from the system default 
for each charge number when this charge number is entered (refer to PROFILE Console Input and 
Multiplier Index Values and Actual Multiplier Values for further information). 

COMSSRU Name Default Value Description 



ADSR Incremental adder (AD) 

Absolute range: 1 to 1000 

In addition to the parameters which make up the SRU formula, the following values are also defined in 
COMSSRU. 
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Minimum Display Value 

This parameter defines the minimum value to be displayed at the end of each time-sharing job step. If 
the accumulated SRUs are less than this value, they are not displayed. 



COMSSRU Name 



MDSR 
Absolute range: 0.001 to 1.000 



Default Value 



0.100 



Description 
Minimum display value 



Minimum Change Value 

This parameter defines the minimum SRU value to be applied against a charge number. If accumulated 
SRUs are less than this value, then a charge equal to this value is applied. 



COMSSRU Name 
MCSR 
Absolute range: 0.001 to 10.000 



Default Value 



1.000 



Description 
Minimum charge value 



IO INCREMENTS 

The 10 parameter in the SRU formula is a measure of the accumulated input/output system activity for a 
user. It accounts for MS activity, MT activity, and PF activity. This parameter is controlled by central 
site defined increments. These increments are assigned to various functions performed by the system. 
These functions include data transfer as well as other operations such as file positioning. 

This section describes the increment of MS, MT, and PF which make up the measurable portion of the 10 
parameter. The common deck COMSSRU contains the definitions, default values, and absolute ranges for 
these increments. To obtain a listing of COMSSRU, assemble CALLSYS. If a site wants to change any of 
the default increments, modifications must be made in COMSSRU. This section lists the IO increments 
with COMSSRU names, default values, and absolute ranges. 



MS Increments 

The formula for calculating the MS increment is 

MS increment = operation charge + penalty + (PRUs transferred x 2l MRW ) 
The following increments are for each operation or for each PRU processed. 

COMSSRU Name Default Increment MS Activity 



IMRL 
IMPO 
IMCO 
IMRS 
IMLL 



Read-with-list 
Position 
Close or open 
Rewind or skip to EOI 
Library load 
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The increments assigned for CIO read and write operations are defined by the following: 
number of increments = (number of PRUs) x (2lM R W) 
COMSSRU Name Default Value 



MS Activity 



IMRW 



2 CIO read or write. Using the IMRW 

default value of 2, four increments 
per PRU are charged for CIO read or 
write. 

If the number of PRUs read in one CIO operation falls within the following ranges, an additional charge is 
made. This charge serves as a penalty for an inefficient 10 transfer. 



COMSSRU Name 

IMSA 
IMSB 
IMSC 



Default 
Additional Charge 
Increment 

4 
2 




Absolute range for MS increments: to 63 
The following describes the increments charged for positioning. 
COMSSRU Name Default Value 



IMPL 



128 



Range 

through 3 PRUs 
4 through 7 PRUs 
8 through infinite PRUs 



Description 

Positioning interval for which IMRL 
increments are charged for each 
read-with-list operation. Using the 
IMRL and IMPL default values, three 
increments are charged for each 128 
PRUs positioned from the current 
position. 



MT Increments 

The formula for calculating the MT increment is 

MT increment = (tape blocks transferred) x (operation charge) 
The following increments are charged for each magnetic tape operation. 

COMSSRU Name Default Increment MT Activity 



ITRW 


4 


Read or write 


ITRL 


5 


Read L tape 


ITPO 


2 


Position 


ITCL 


1 


Open or close 


ITWL 


6 


Write L tape 



Absolute range for MT increments: to 63 
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PF Increments 

The formula for calculating the PF increment is 

PF increment = operation charge + IPPR (PRUs transferred/IPPN) 
The following increments are charged for each permanent file operation. 

COMSSRU Name Default Increment PF Activity 



IPSV 


1 


Save 


IPRP 
IPGT 


1 
1 


Replace 
Get 


IPAP 
IPDF 


20 
4 


Append 
Define 


IPAT 


4 


Attach 


IPPM 


1 


Permit 


IPCG 
IPPG 
IPCT 


1 
1 
1 


Change 

Purge 

Catlist 


IPCS 


4 


Catalog search 


IPCE 
IPVA 



1 


Catalog entry returned 
VALID Us access 


IPPA 


1 


Permit file access 


IPAD 


1 


Alternate device access 



The following increment is charged each time a specified number of PRUs are transferred. 
COMSSRU Name Default Increment 

IPPR 4 

The following specifies the number of PRUs transferred before the IPPR increment is charged. 



COMSSRU Name 
IPPN 



Default Value Description 

10 Using the default value, the IPPR 

increment is charged each time 10 
PRUs are transferred. 

Absolute range for PF increments: to 63 

Example: 

The charge for an ATTACH(filenam/PN=packnam,UN=usernum) statement is calculated as follows. 

IPAT+IPAD+IPVA+IPCS+IPPA (if permit data is available) 

EXAMPLE OF SRU CALCULATION 

This section illustrates how an SRU value is obtained. The SRU formula is as follows. 
SRU = Ml (CP + M2 x 10 + M3 (CP + 10) CM + M4 (CP + IO)EC) + AD 
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The parameters are described in the SRU Formula section. For this example, all default values are 
assumed, except AD which equals 1.0. Therefore, the following parameters are known. 



50 = 1.0 Ml = 1.0 AD = 1.0 

51 = 1.0 M2 = 0.100 

52 = 1.0 M3 = 0.003 

53 = 1.0 M4 = 0.0 

54 = 1.0 



For the purpose of this example, it is assumed that the job or session accumulated the following amounts 
of the specified resources. 

9135 milliseconds of CPU time on CPU (CP0 = 9135) 

millisecond of CPU time on CPU 1 (CP1 = 0.0) 

28,880 units of mass storage (MS = 28880) 

No magnetic tape or permanent file usage (MT = 0.0, and PF = 0.0) 

No ECS usage (EC = 0.0) 

105008 CM field length 

To solve for the CP parameter, the following formula is used. 

CP= SO x CP0 + SI x CP1 
= 1.0x9135 + 1.0x0.0 
= 9135 

so 

CP = 9135 milliseconds 

To solve for the IO parameter, the following formula is used. 

IO = S2 x MS + S3 x MT + S4 x PF 
= 1.0 x 28880 + 1.0 x 0.0 + 1.0 x 0.0 
= 28,880 

so 

IO = 28,880 milliunits 

To solve for the CM parameter, the following formula is used. 

CM= (CM field length + 777 8 )/1000 8 (the 777g is used as a roundup factor) 
= (10500 8 + 777 8 )/1000 8 

= 118 
= 9 

so 

CM= 9 units 
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To solve for the EC parameter, the following formula is used. 

EC = ECS field length in tracks 
= 

so 

EC = units 

Since the AD parameter is specified in units and the remainder of the SRU equation is specified in 
milliunits, this part is computed first and converted into units. It can then be added to the AD parameter 
to obtain the number of SRUs. 



Ml (CP + M2 x 10 + M3 (CP + 10) CM + M4 (CP + IO) EC) 

= 1.0(9135 + 0.100 x 28880 + 0.003(9135 + 28880)9+0) 

= 9135 + 2888 + 1026.405 

= 13049.405 

= 13049 milliunits 

= 13.049 units 

so 

SRU = 13.049 + AD 
= 13.049 + 1.0 
= 14.049 units 

So, during this job or session, 14.049 SRUs have been accumulated. 



MULTIPLIER INDEX VALUES AND ACTUAL MULTIPLIER VALUES 

When a site assigns charge numbers, it can specify certain multipliers (Ml through M4) and the adder 
(AD) in the SRU multiplier formula as other than the system default values. (The system default values 
are described in the IO Increments section.) In fact, each charge number may be assigned a unique set of 
multiplier and adder values. This is done using the PROFILE control statement and the Ml through M4 
directives (refer to PROFILE Console Input). An index from to 77 g is specified with each directive 
which is converted to the actual multiplier or adder value. The actual multiplier or adder value must lie 
within the absolute range defined by the system for that parameter. However, each site can also specify 
a subrange for each multiplier or adder in which all multipliers or adders must lie. This is done by 
specifying upper and lower bounds for these parameters. The released values for these upper and lower 
bounds are contained in COMSSRU. To obtain a listing of COMSSRU, assemble CALLSYS. To change 
these values, modifications must be made in COMSSRU. The following lists the COMSSRU names and 
gives the released values. 



5-70 



COMSSRU Name 


Released Value 


Description 


M1SL 


0.5 


Ml lower bound 


M1SU 


1.5 


Ml upper bound 


M2SL 


0.050 


M2 lower bound 


M2SU 


0.150 


M2 upper bound 


M3SL 


0.001 


M3 lower bound 


M3SU 


0.064 


M3 upper bound 


M4SL 


0.001 


M4 lower bound 


M4SU 


0.064 


M4 upper bound 


MASL 


1 


Adder (AD) lower bound 


MASU 


64 


Adder (AD) upper bound 
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When a site specifies an index value for Ml, M2, M3, M4, or AD under PROFILE, it is converted to the 
actual multiplier (or adder) value by the following formula. 

MI = KMISU - MISD/64 + MISL 

Parameter Description 



MI Actual multiplier (or adder) obtained 

I Multiplier (or adder) index value entered with a PROFILE directive 

MISU Multiplier (or adder) upper bound 

MISL Multiplier (or adder) lower bound 
Two exceptions are: 

• If the index value is entered in the PROFILE directive, an actual multiplier (or adder) value of 
is assigned, 

• If the upper index value 77g is entered or if no index value is entered in the PROFILE directive, 
the system default multiplier (or adder) is assigned. 

The actual multiplier (or adder) value MI and the index value I are displayed on the PROFILa K display 
(refer to figure 5-15). 

The following example illustrates a conversion of an index value to an actual multiplier. 

Example 1: 

Assume that the released upper and lower bounds for M2 are used. That is: 

M2SL = .050 
M2SU = .150 

The site specifies a PROFILE directive 

M2 = 32 
for a particular charge number. This implies that the index value I in the formula 

MI = KMISU - MISD/64 + MISL 

is equal to 32. 

Upon substitution: 

M2 = 32(.150 - .050)/64 + .050 
= 3.200/64 + .050 
= .050 + .050 
= .10 

Thus, the actual M2 multiplier used for this charge number is .10. 

After a site has chosen upper and lower bounds for its multipliers (and adder), it may desire to assign 
different actual multiplier values to certain charge numbers. In order to choose the proper index value 
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to be specified on the PROFILE directives, the following formula is used. (This is merely the previous 
formula solved for I.) 

I = 64(MI - MISL)/(MISU - MISL) 

I, MI, MISL, and MISU are the same as those defined previously. 

Example 2: 

Assume that the released upper and lower bounds for M2 are used. That is: 

M2SL = .050 
M2SU = .150 

The site wishes to assign an actual M2 multiplier value of .10 to a particular charge number. To 
determine the appropriate index value for the PROFILE directive, the following formula is used. 

I = 64 (MI - MISL)/(MISU - MISL) 

MI = .10 in this case. 

Upon substitution: 

I = 64U00 - .050)/(.150 - .050) 

= 64(.050)/(.100) 

= 64 x .5 

= 32 

Thus, the PROFILE directive M2 = 32 should be entered for the particular charge number to specify an 
actual M2 multiplier value of .10. 



ACCOUNT DAYFILE MESSAGES 

The purpose of the account dayfile is to provide a history of system usage over the life of the account 
dayf ile. This history is used for the following purposes. 

• It provides the information necessary to properly bill the users of the system. 

• It provides the necessary information to analyze the use of the system or any part of it by the 
installation. For example, the installation may want to determine the amount of magnetic tape 
usage. 

Therefore, a standardized message format is provided to ease in the account dayfile analysis. The 
following is the general format of the account dayfile message. All account dayfile messages have this 
general format. 

hh.mm.ss.jobnameo.geac, additional information 

Message Description 

hh.mm.ss. Current time in the form of hour.minute.seeond. This field 

begins in column 2 and ends with a period. The system always 
appends this field in this format to the beginning of the message 
at the time it is entered into the account dayfile. 

jobname Name of the job which caused the entry of this message into the 

account dayfile. This field begins in column 11 and ends in 
column 17. The system appends this field to the beginning of 
the message along with the time. 
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Message 



Description 

A single character in column 18 which describes the origin type 
of the job. The system automatically appends this character 
when the message is entered into the account dayfile. The 
following origin types can be specified. 






Origin Type 


S 


System 


B 


Batch 


T 


Terminal 


E 


Remote batch 


M 


Multiterminal 



geac 



additional information 



A unique four-character message identifier which defines the 
particular activity identified. The field begins in column 21 and 
ends with a comma-blank (, ). The first character identifies the 
information group, the second character identifies the event 
which caused the message to be entered into the account 
dayfile, and the last two characters identify the activity being 
recorded. This field is further described in the following 

co/»+is\n 

Information that gives further detail to the activity identified 
by geac. The field begins in column 27 and ends with a period. 
This field is further described in the following section. 



These message lines are free format. That is, each field defined in a message ends in either a 
comma-space or a period if it is the last field in the message. If a field is not used, it appears only as a 
comma-space, or it does not appear if it is the last field in the message. The separator immediately 
follows the last character of the field. The field size can be any length, depending on the information 
being supplied. 

Example: 

SPAT, filea, , packnam. 

No alternate user access was specified during the permanent file attach operation. 

SPAT, filenam. 

No pack name was required and no alternate user access was specified during the permanent file 
attach operation. 

Refer to Message Groups for a description of this message. 
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MESSAGE GROUPS 

All account dayfile entries are grouped by a particular information type. Each group type is identified by 
the first character of the geac field (that is, g of geac) in the account dayfile message. The following 
are the group types. 

Type Description 



Aeac Accounting information. 

Seac Statistical information. 

Ueac Job usage information. 

Ieac Installation information (reserved). 

Accounting Information 

The A message group provides the information necessary for accounting purposes. These messages 
include information denoting the beginning and end of an accounting sequence, a well as all resources 
used. The message formats are: 

Aeac, additional information. 

The events (e character of Aeac) are defined as follows. Some characters are not currently utilized by 
the system. 



Character 


Event Description 


B 


Beginning of a job or session. 


C 


Change in the accounting activity. 


D 


Disk activity. 


E 


End of a job or session. 


M 


Magnetic tape activity. 


P 


Permanent file activity. 


R 


Recovery operation. 


S 


Suspension of a session. 


u 


Unable to update PROFILa. 



The activity identifier (ac of geac) identifies the information being recorded and is event dependent. 
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The following is a list of the B activity messages. 

ABAP, CI, usernum, family, termnam. 

ABAP, C2, application. 

ABCN, chargenum, projectnum. 

ABER, termnam. 

ABER, CI, usernum, family, termnam. 

ABER, C2, passwrd. 

ABSY, yy/mm/dd. 

ABUN, usernum, family, termnam. 



Identifier 



ABAP 



ABCN 



Description 



ABSY 



ABUN 



Denotes transfer of terminal termnam logged in under user usernum in 
specified family to application after validation by NETVAL. 

Denotes the beginning of a charge sequence: 

chargenum 1- to 10-alphanumeric character charge number. 

projectnum 1- to 20-alphanumeric character project number. 

r>onntoo ill/yrol 1r»orin attomnt of tptrninfll tppmnflm, S<=r»nnrl fnrm is issilPrl if 
i^v.ivivu "i*^,"i -^ft"' «*wv^»»«|*» v~v „~.. ...***.-. ^ -~* .. ...>_•... ... — — 

selected by NETVAL control statement option (refer to the NOS Installation 
Handbook). 

Denotes the beginning of a new account dayfile through initialization of 
dayfiles or dayfile termination on date yy/mm/dd. Two blanks separate yy 
from the comma that precedes it. 

Denotes the beginning of a job or terminal session under user number usernum 
in the permanent file family family; termnam is optional. If present, message 
represents NAM login at terminal termnam. 



The following is a list of the C activity messages. 

ACCN, chargenum, projectnum. 
ACDT, DS, DATE, yy/mm/dd 
ACDT, DS, TIME, hh.mm.ss 
ACSO, sruunits. 
ACSR, sruunits. 
ACUN, usernum, family. 
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Identifier Description 

ACCN Denotes a change of charge with the charge number ehargenum and the 

project number projectnum. 

ACDT Denotes new date or time entered into the system. 

ACSO Denotes overflow of SRU accumulation in SRU units. 

ACSR Denotes the end of an accounting block that used sruunits of SRUs. The SRU 

accumulator is displayed and cleared and is associated with the entering of a 
new charge/project number. 

ACUN Denotes the change to a user number usernum under the permanent file 

family family. 

The following is a list of the D activity messages. 

ADDx, es, family, dn. 
ADPy, es, packnam, usernum. 



Identifier 



Description 



ADDx 



Denotes operation on a permanent file device: 



Parameter 



Description 



ADPy 



X 


Operation: 

I Initialization 


es 

family 

dn 


R Recovery 

U Unloading 
Equipment status table ordinal of equipment 
Family name of device 
Device number 


lotes operation 


on an auxiliary removable disk pack: 


Parameter 


Description 



es 

packnam 

usernum 

The following is a list of the E activity messages. 

AEAP, CI, usernum, family, termnam. 

AEAP, C2, application, xxxxxxSECS. 

AENR, usernum, family. 

AEPQ, qt. 

AESR, sruunits. 

AESY, yy/mm/dd. 

AEUN, usernum, family, termnam. 



Operation: 

D Dismounting 

I Initialization 

M Mounting and recovery 
Equipment status table ordinal of equipment 
Name of disk pack 
User number of disk pack 
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Identifier 



AEAP 



AENR 



AEPQ 



Description 

Denotes end of connection of terminal termnam to specified application. 
Elapsed time of connection (xxxxxx, in seconds) may not agree with interval 
between corresponding ABAP and AEAP messages, because calculation of 
elapsed time is independent of the system function that prefixes the time 
field to the account dayfile message. 

Denotes the discarding of user usernum on family family from the 
time-sharing recovery file. 

Denotes the purging of the job from the I/O queue: 

Parameter Description 



qt 



AESR 



AESY 



AEUN 



Type of queue 

IN Input queue 

PH Output punch queue 

PR Output print queue 



Denotes the end of a job or session that used sruunits SRUs under the current 
charge number. 

Denotes the end of an active account file on the date yy/mm/dd. Two blanks 
separate yy from the comma that precedes it. 

Denotes the end of a user number activity (for remote batch logoff 
operation); termnam is optional. If present, denotes logoff from network 
terminal termnam. 



The following is a list of the M activity messages. 

AMAS, es, vsn. 
AMRT, es, onX. 



Identifier 



AMAS 



AMRT 



Description 



The magnetic tape equipment es is assigned with a volume serial number vsn. 
If the tape is unlabeled, vsn is not used. 

Denotes magnetic tape equipment es returned from the user. onX specifies 
the type of drive returned and is specified as 66 X or 67X. 



The following is a list of the P activity messages. 

APPN. 

APPN, packnam. 



Identifier 



Description 



APPN 



Denotes entering the default pack name. If no pack name is specified, the 
message denotes the clearing of the default pack name. 
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The following is a list of the R activity messages. 

ARSY, In, yy/mm/dd. 
ARUN, usernum, family, tn. 



Identifier 
ARSY 

ARUN 



Description 



Denotes the recovery of the account dayfile at recovery level In on the date 
yy/mm/dd. Two blanks separate yy from the comma that precedes it. 

Denotes the recovery of a time-sharing session with user number usernum, 
family name family, and terminal number tn. 



The following is a list of the S activity messages. 

ASSR, xxxxxx.xxxUNTS. 

ASDx, usernum, family. 

ASNx, usernum, family. 

ASTx, usernum, family. 



Identifier 
ASSR 

ASDx 

ASNx 

ASTx 



Description 



Denotes the suspension of a job or session that used the indicated amount of 
SRUs under the current charge number. 

Denotes that the user number and logical terminal name are duplicated in the 
time-sharing recovery file. The current session is ignored. 

Denotes that the user has not been successfully entered into the time-sharing 
recovery file. 

Denotes that the user has been saved in the time-sharing recovery file: 



x 
H 
R 



Description 

The recovery operation was caused by a hang up. 

The recovery operation was caused by the recovery of the 
time-sharing subsystem. 



T The recovery operation was caused by a session timeout. 

The following is a list of the U activity messages. 
AUSR, sruunits. 

Identifier Description 



AUSR 



Denotes that sruunits of SRUs could not be recorded in PROFILa at overflow 
or end of account block. 
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Statistical Information 

The S message group provides information relating to the various activities of the system. The message 
formats are as follows: 

Seac, additional information. 

The events (e character of Seac) are defined as follows. Some characters are not currently utilized by 
the system. 



Character 



Event Description 



A Subsystem abort. 

B Subsystem begin. 

C Accumulator displayed and cleared. 

D Accumulator displayed and continued. 

E Subsystem end. 

I Informative message. 

P Permanent file information. 

R Subsystem recovery. 

The following is a list of the A activity messages. 
SANW, application, jobnanu 

Identifier Description 



SANW Denotes application failure during job jobnam. 

The following is a list of the B activity messages. 

SBER, application, jobnam. 
SBNW, application, jobnam. 



Identifier 
SBER 
SBNW 



Description 
Denotes illegal NETON attempt by application during job jobnam. 
Denotes successful NETON by application during job jobnam. 
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The following is a list of the C activity messages. 



SCAE, xxxxxx.xxxKUNS. 

SCAP, xxxxxx.xxxKUNS. 

SCAS, xxxxxx.xxxKUNS. 

SCLE, xxxxxx.xxxKUNS. 

SCLG, xxxxxx.xxxKUNS. 

SCLN, node, CI, port, 0, 0, blocks t . 

SCLN, node, C2, blocks p chars. 

SCLN, node, C3, blocks e . 

SCMT, es, pppppppp, t. 

SCNP, node, CI, statistics^ 

SCNP, node, C2, statistics,. 

SCNP, node, C3, statistics 3 . 

SCTR, node, CI, port, 0, mode, blocks t . 

SCTR, node, C2, blocks pC hars. 

SCTR, node, C3, blocks e . 



Identifier 
SCAE 
SCAP 
SCAS 
SCLE 
SCLG 
SCLN 



SCMT 



Description 



Denotes number of illegal application selections divided by 1000. 

Denotes number of prohibited application selections divided by 1000. 

Denotes number of legal application selections divided by 1000. 

Denotes number of illegal login attempts divided by 1000. 

Denotes number of legal login attempts divided by 1000. 

Denotes the number of blocks and characters transmitted and received on the 
line connected to the indicated port of the NPU with node number node. The 
port number is hexadecimal; all other values are decimal. 



Field 



blocks* 



blocks r chars 



Description 
Number of blocks transmitted. 
Three contiguous six-digit fields as follows: 
blocks received characters received 

rrrrrrttttttrrrrrr 



blocks. 



characters transmitted 
Character counts include only counts from good blocks. 
Number of blocks transmitted or received in error. 



Denotes the number of magnetic tape PRUs transferred from unit es; t 
denotes whether the blocks were read (t=R) or written (t=W). 
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Identifier 



Description 



SCNP 



SCTR 



Indicates various statistics about the NPU with node number node. All values 
are decimal, statistics-^, statistics2, and statistics3 each consist of three 
six-digit fields as follows: 



statistics-^: 

statistics2: 

statistics3: 

Field 

gggggg 

PPPPPP 

rrrrrr 

aaaaaa 

ffffff 

nnnnnn 

tttttt 

oooooo 

zzzzzz 



ggggggpppppprrrrrr 
aaaaaaffffff nnnnnn 
ttttttoooooozzzzzz 

Description 



Number of service messages generated. 

Number of service messages processed. 

Number of bad service messages received. 

Number of blocks discarded because of bad address. 

Number of packets/blocks discarded because of bad 
format. 

Number of times that the NPU entered regulation 
level 3 (that is, its original state of no regulation). 

Number of times that the NPU entered regulation 
level 2. 

Number of times that the NPU entered regulation 
level 1. 

Number of times that the NPU entered regulation 
level 0. 



Denotes the number of blocks and characters transmitted and received by the 
NPU with node number node on the trunk connected to the indicated port. 
The node number of the remote NPU to which the trunk is connected is mode; 
port is hexadecimal; all other values are decimal. 



Field 



blocks^- 



blocks r chars 



Description 
Number of blocks transmitted. 
Three contiguous six-digit fields as follows: 
blocks received characters received 



rrrrrr ttttttrrrrrr 



blocks. 



characters transmitted 

Character counts include only counts from good 
blocks. 

Number of blocks transmitted or received in error. 
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The following is a list of the D activity messages. 

SDCA, seconds. 

SDCI, seconds. 

SDCM, kilomoves. 

SDMR, kilorollouts. 

SDMS, kilosectors. 

SDTO, kiloslices. 

SDTS, kiloslices. 



Identifier 



SDCA 



SDCI 



Description 



Denotes accumulated time since deadstart that the CPU was active at the 
system control point while in program mode. 

Denotes accumulated time since deadstart that the CPU was not assigned to 
any control point; that is, executing its idle loop. 



NOTE 



The following D activity messages should not be 
considered permanent features of NOS and may be 
removed from the system when the need to 
maintain the information that they provide no 
longer exists. 



SDCM 

SDMR 
SDMS 
SDTO 

SDTS 



Number of storage moves, divided by 1000, in which a job field length was 
moved. 

Number of rollouts, divided by 1000, for all jobs. 

Number of sectors rolled out, divided by 1000, for all jobs. 

Number of user limits and time slices with output present detected by ISP, 
divided by 1000, for all jobs. 

Number of time slices detected by ISP, divided by 1000, for all jobs. 



The following is a list of the E activity messages. 

SEMC, xxxxxx.xxx KUNS. 
SENW, application, jobnam. 



Identifier 
SEMC 

SENW 



Description 



Denotes program disconnection from MCS and weighted number of calls to 
MCS. 

Denotes NETOFF by application during job jobnam. 
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The following is a list of the I activity messages. 



SIAD. 




SIAD, 


yy/mm/dd. 


SIAE, 


xxxxxx.xxxKUNS. 


SIAP, 


xxxxxx.xxxKUNS. 


SIAS, 


xxxxxx.xxxKUNS. 


SISC, 


nn. 


SISC. 




SILE, 


xxxxxx.xxxKUNS. 


SILG, 


xxxxxx.xxxKUNS. 


SITA, 


xxxxxx.xxxKUNS. 


SIUN, 


usernum. 


SIWA, 


attempts, interval, 


SIWL, 


attempts, interval, 


Identifier 



SIAD 

SIAE 
SIAP 
SIAS 
SISC 

SILE 
SILG 
SITA 
SIUN 

SIWA 
SIWL 



Description 

If issued with no parameters, denotes dumping of account dayfile. If issued 
with date following SIAD, denotes execution of engineering services program 
GETLOG. Two blanks separate yy from the comma that precedes it. 

Denotes illegal application switches through NVF (network validation facility). 

Denotes prohibited application switches through NVF. 

Denotes legal application switches through NVF. 

Denotes user security count decremented to the value nn. If issued with no 
parameter, denotes user has violated security, but the system was unable to 
decrement the user security count because VALID Us was not currently 
available. 

Denotes illegal login through NVF. 

Denotes legal login through NVF. 

Denotes current number of terminals controlled by NVF. 

Denotes attempt to enter illegal user number, usernum, or secondary user 
number, usernum, while secondary user card feature is disabled. 

Indicates the number of illegal application attempts made during the 
indicated interval (in seconds). This message is issued only if the appropriate 
NETVAL control statement parameters are set (refer to the NOS Installation 
Handbook). 

Indicates the number of illegal network login attempts made during the 
indicated interval (in seconds). This message is issued only if the appropriate 
NETVAL control statement parameters are set (refer to the NOS Installation 
Handbook). 
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The following is a list of the P activity messages. 

SPAP, filenam, usernum, packnam. 

SPAT, filenam, usernum, packnam. 

SPCG, filenam, usernum, packnam. 

SPCT, filenam, usernum, packnam. 

SPDF, filenam, usernum, packnam. 

SPGT, filenam, usernum, packnam. 

SPPG, filenam, usernum, packnam. 

SPPM, filenam, usernum, packnam. 

SPRP, filenam, usernum, packnam. 

SPSV, filenam, usernum, packnam. 

Identifier Description 



SPAP Denotes permanent file APPEND operation. 

SPAT Denotes permanent file ATTACH operation. 

SPCG Denotes permanent file CHANGE operation. 

SPCT Denotes permanent file CATLIST operation. 

SPDF Denotes permanent file DEFINE operation. 

SPGT Denotes permanent file GET operation. 

SPPM Denotes permanent file PERMIT operation. 

SPPG Denotes permanent file PURGE operation. 

SPRP Denotes permanent file REPLACE operation. 

SPSV Denotes permanent file SAVE operation. 
The remainder of the S group messages are not used; they are reserved for future expansion. 

Usage Information 

The U message group provides a breakdown of the usage of the system for a particular user. The 
message formats are: 

Ueac, usage count descriptor. 

The events (e character of Ueac) are defined as follows: 

Character Event Description 

B Accumulator begun. 

C Accumulator displayed and cleared. 

D Accumulator displayed and continued. 

E Accumulator displayed and ended. 

S Accumulator suspended. 
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The activities (ae characters of Ueac) are defined as follows: 
Character Activity Description 

AD SRU adder accumulator. 

AU Application program accumulator. 

CI Characters transmitted into the system. 

CO Characters transmitted out of the system. 

CP CPU time. 

CR Cards read. 

LP Lines printed. 

LV Lines printed, V carriage control encountered. 

MS Mass storage activity. 

MT Magnetic tape activity. 

PC Cards punched. 



Doom nnstivt- f<l/> nntitnfn 

jc ciiucuicm m.uxz a^uvnji 



PF 

PL Plotter activity. 

Each accumulator is displayed in F10.3 format with a four-character unit descriptor after the value. The 
following are the descriptors. 



Descriptor 


Value 


KCHS 


Kilo-characters 


KCDS 


Kilo-cards 


KLNS 


Kilo-lines 


KPLS 


Kilo-plot-units 


KUNS 


Kilo-units 


SECS 


Seconds 


UNT3 


Units 


following is a B 


activity message. 


UBAU, xxxx. 




Identifier 





Deseription 

UBAU Denotes the beginning of the application program accumulator for the 

application xxxx. 

Certain C event activity messages contain a field, minn, identifying the equipment upon which the 
particular activity took place. The first two characters of minn are the machine identifier (MID entry in 
CMRDECK; refer to the NOS Installation Handbook). The remaining characters are either the equipment 
status table ordinal or terminal name of the device that performed the activity. 
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The following is a list of the C activity messages. 

UCAD, xxxxxx.xxxKUNS. 
UCCI, xxxxxx.xxxKCHS. 
UCCO, xxxxxx.xxxKCHS. 
UCCR, minn, xxxxxx.xxxKCDS. 
UCLP, minn, xxxxxx.xxxKLNS. 
UCLV, minn, xxxxxx.xxxKLNS. 
UCMS, xxxxxx.xxxKUNS. 
UCMT, xxxxxx.xxxKUNS. 
UCPC, minn, xxxxxx.xxxKCDS. 
UCPF, xxxxxx.xxxKUNS. 
UCPL, minn, xxxxxx.xxxKPLS. 



Identifier 
UCAD 
UCCI 

UCCO 

UCCR 

UCLP 

UCLV 

UCMS 

UCMT 

UCPC 

UCPF 

UCPL 



Description 

Denotes the value of the adder accumulator for a job when overflow occurred. 

Denotes the number of characters transferred into the system for a job (for 
time-sharing subsystem). 

Denotes the number of characters transferred out of the system for a job (for 
time-sharing subsystem). 

Denotes the number of cards read into the system for a job on equipment 
minn (described earlier). 

Denotes the number of lines printed for a job on equipment minn (described 
earlier). 

Denotes the number of lines printed for a job in which the V carriage control 
character was used on equipment minn (described earlier). 

Denotes the value of the mass storage activity accumulator for a job when 
overflow occurred. 

Denotes the value of the magnetic tape activity accumulator for a job when 
overflow occurred. 

Denotes the number of cards punched for a job on equipment minn (described 
earlier). 

Denotes the value of the permanent file activity accumulator for a job when 
overflow occurred. 

Denotes the number of plot-units plotted for a job on equipment minn. 



The following is a list of the D activity messages. 

UDAD, xxxxxx.xxxUNTS. 
UDCI, xxxxxx.xxxKCHS. 
UDCO, xxxxxx.xxxKCHS. 
UDCP, xxxxxx.xxxSECS. 
UDMS, xxxxxx.xxxKUNS. 
UDMT, xxxxxx.xxxKUNS. 
UDPF, xxxxxx.xxxKUNS. 
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Identifier 



Description 



UDAD 
UDCI 

UDCO 

UDCP 
UDMS 
UDMT 
UDPF 



Denotes the SRU adder accumulator for a job. 

Denotes the number of characters transferred into the system for a job 
(currently available for time-sharing only). 

Denotes the number of characters transferred out of the system for a job 
(currently available only for time-sharing). 

Denotes the CPU time for a job. 

Denotes the mass storage activity accumulator for a job. 

Denotes the magnetic tape activity accumulator for a job. 

Denotes the permanent file activity accumulator for a job. 



The following is a list of the E activity messages. 

UEAD, xxxxxx.xxxUNTS. 

UEAU, xxxxxx.xxxUNTS. 

UECI. xxxxxx.xxxKCHS. 

UECO, xxxxxx.xxxKCHS. 

UECP, xxxxxx.xxxSECS. 

UEMS, xxxxxx.xxxKUNS. 

UEMT, xxxxxx.xxxKUNS. 

UEPF, xxxxxx.xxxKUNS. 



Description 



Identifier 

UEAD Denotes the SRU adder accumulator for a job. 

UEAU Denotes the application program accumulator for a job step. 

UECI Denotes the number of characters transferred into the system for a job 

(currently available only for time-sharing). 

UECO Denotes the number of characters transferred out of the system for a job 

(currently available only for time-sharing). 

UECP Denotes the CPU time for a job. 

UEMS Denotes the mass storage activity accumulator for a job. 

UEMT Denotes the magnetic tape activity accumulator for a job. 

UEPF Denotes the permanent file activity accumulator for a job. 

The following is a list of the S activity messages. 

USAD, xxxxxx.xxxUNTS. 

USAU, xxxxxx.xxxUNTS. 

USCP, xxxxxx.xxxSECS. 

USMS, xxxxxx.xxxKUNS. 

USMT, xxxxxx.xxxKUNS. 

USPF, xxxxxx.xxxKUNS. 
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Identifier 
USAD 
USAU 
USCP 
USMS 
USMT 
USPF 



Description 
Denotes the SRU accumulator for a job. 
Denotes the application program accumulator for a job step. 
Denotes the CPU time for a job. 

Denotes the mass storage activity accumulator for a job. 
Denotes the magnetic tape activity accumulator for a job. 
Denotes the permanent file activity accumulator for a job. 



The following usage summary for a user is always issued. 



UeCO, xxxxxx.xxxKCHS. 
UeCI, xxxxxx.xxxKCHS. 
UeAD, xxxxxx.xxxUNTS. 
UePF, xxxxxx.xxxKUNS. 
UeMS, xxxxxx.xxxKUNS. 
UeMT, xxxxxx.xxxKUNS. 
UeCP, xxxxxx.xxxSECS. 
UeSR, xxxxxx.xxxUNTS. 



Time-sharing users only. 
Time-sharing users only. 



Tape users only. 



e is an event identifier described in this section. 
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SYSEDIT 



After the system is loaded, the SYSEDIT control statement provides a method of performing 
modifications to the system library, A job containing a SYSEDIT control statement must either be a 
system origin job, or the user must be validated for system origin privileges and have DEBUG set at the 
system console. The system processes only one SYSEDIT control statement at a time. If one SYSEDIT 
has not completed when a second SYSEDIT statement is entered, the second SYSEDIT aborts. 



NOTE 



The use of SYSEDIT in a production environment may cause 
unpredictable results and is not recommended. The system should be idle 
to ensure predictable results. 



The format of the control statement is 

SYSEDIT( Pl ,p 2 ,...,p n ) 
where pj is either a keyword or a keyword equated to a value. 

Pi Description 

B=filenam Replacement records are on file filenam. 

B Same as B=LGO. 

8=0 No replacement file. 

B omitted Same as B=LGO. 

C Checkpoint of the system follows SYSEDIT. 

C omitted No checkpoint is performed unless the system was generated employing the 

alternate system library residency feature, and in that case the checkpoint 
automatically follows SYSEDIT. 

I=filenam Directive input is on file filenam. 

I Same as I=INPUT. 

1=0 No directive input. 

I omitted Same as I=INPUT. 

L=filenam List output is on file filenam. 

L Same as LOUTPUT. 

L=0 No list output. 

L omitted Same as L=0. 
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Pj Description 

R=n Restoration is made to copy n of the system. The system copy number is 

printed on the output listing. 

R Restoration is made to initial deadstart system. 

R=0 No system file restoration. 

R omitted Same as R=0. 

Z Directive input follows the terminator on the control statement. The I option 

is ignored. 

Z omitted The system uses the I option for directive input. 



NOTE 



If the Z option is specified, a terminator must not 
be placed after the input directives. 



The following are input directives to SYSEDIT. *CM, *MS, *AD, *PROC, *FL, and *SC directives can be 
placed on LIBDECK (refer to the NOS Installation Handbook). A list of valid record types follows the 
directive descriptions. 



*CM DIRECTIVE 

The *CM directive specifies the system library routines that are to reside in central memory resident. 
These routines will reside in the resident peripheral library (RPL) and resident central library (RCL). 

The format of the directive is: 

*CM,ty 1 /rec 1 ,ty 2 /rec 2 ,...,ty n /rec n . 

tyj/recj Record type and record name of the routine. 

Central memory has the best accessibility of all storage devices. The following programs wiU 
automatically reside in central memory. 

• Mass storage drivers. 

• Programs specified in the internal tables of SLL (SYSEDIT service routine), such as 1DD and 
ODF. 

In addition, it is suggested that high usage PP and CPU programs (such as PFILES, CONTROL, 1MT, and 
PFM) reside in central memory. 

Any addition to central memory allows less space for user jobs. 

REL type records cannot reside in central memory. 
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•MS DIRECTIVE 

The *MS directive identifies which system library routines will reside on the system device. It is the 
default residence for routines; any routine not specified as *CM will automatically reside on the system 
device, even if *MS is not entered in the LIBDECK. System device routines may also be placed on an 
alternate system device with an *AD assignment. 

The format of the directive is: 

*MS,ty 1 /rec 1 ,ty 2 /rec 2 ,...,ty n /rec n . 

tyj/recj Record type and record name of the routine. 



*AD DIRECTIVE 

The *AD directive places copies of specific system library routines on particular mass storage devices so 
that they will be accessed from a device other than the system device. For example, it is advantageous: 

• To place frequently used system library routines in ECS for faster access than is possible from 
the system device. 

• To place PP routines on a mass storage device that has better latency than does the system 
device. 

Once a routine is on an alternate system device, it is accessed from that device instead of from the 
system device (*MS LIBDECK entries), except in the following cases of error recovery. 

• If there is an unrecoverable error for a PP routine on an alternate system device, all of the PP 
routines will subsequently be accessed from the system device instead of from any of the 
alternate system devices. 

• If there is an unrecoverable error for a CPU, ABS, or OVL routine on an alternate system 
device, only that routine will subsequently be accessed from the system device. 

• If there is an unrecoverable error for an REL CPU routine, the alternate system device must be 
turned off by the operator to prevent further access to the routine. In this case, the system 
copy will be used for backup. The alternate system device is not used for loads. 

The devices that are to be used as alternate system devices are specified with the ASR entry in the 
CMRDECK (refer to the NOS Installation Handbook); the routines that are to reside on each alternate 
system device are specified in LIBDECK. 

The format of the directive is: 

*AD,xx,ty 1 /rec 1 ,ty 2 /rec 2 ,...,ty n /rec n . 

xx One- or two-digit (octal) EST ordinal or two-character equipment type of the 

equipment to be used as an alternate system device. 

The equipment can be any nonremovable mass storage device (including ECS) 
except for a system device. 
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If the equipment is not specified in the CMRDECK with the ASR entry, the 
*AD entry is ignored without an error indication when the system is loaded. 

tyj/recj Record type and record name of the routine. 

tyj Record type of routine: 

ABS CPU multiple entry point overlay 

OVL CPU overlay 

PP PP absolute 

REL Relocatable CPU routine 

If a record type other than ABS, OVL, PP, or REL is specified, 
the message ILLEGAL CM/AD RESIDENCE, is issued to the 
output device; the run is aborted. 

recj Record name of routine. 

A routine is allowed on only one alternate system device. 
Note the following additional qualifications. 

• Once a routine is placed on an alternate system device, SYSEDIT may be used to prohibit access 
to the routine; however, the space for that routine is not released until LIBDECK is modified 
and the system is reloaded. 

• If ECS is an alternate system device, all ABS, OVL, or REL routines residing there will be 
loaded directly by central monitor function LCEM. This causes the transfer of a program from 
ECS directly to the load address. 

• If DDP is available, PP programs residing on ECS will be loaded via DDP, and CPU programs 
will be loaded via the CPU access to ECS. 



*PROC DIRECTIVE 

The *PROC directive identifies a record as a procedure. As such, it can be treated as any control 
statement, invoked by name with parameters as required by the procedure itself. The records specified 
with this directive can be either CCL or KCL procedures. Further information on procedure creation and 
execution can be found in the NOS Reference Manual, volume 1. 

The format of the directive is: 
*PROC,rec 1 ,rec 2 ,...,rec n . 

reef Record name of routine to be defined as a procedure file. 
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*SC DIRECTIVE 

The *sc directive specifies the statements in a certain program that are to be processed in product set 
format rather than NOS format (refer to NOS Reference Manual, volume 1). 

The format of the directive is: 

*SC,ty 1 /rec 1 ,ty 2 /rec2,..vty n /rec n . 

tyj/recj Record type and record name of the routine to be processed in product set 

format. 



*FL DIRECTIVE 

The *FL directive specifies the field length that routines to be loaded require to begin execution. 
The format of the directive is: 

*FL ? ty 1 /rec 1 -fl l5 ty 2 /rec 2 -fl25»^ t yn/ rec rr fl n' 

tyj/recj Record type and record name of the routine. 

flj Field length/1 00s required by the routine. 

The actual field length obtained is subject to the rules governing RFL= and MFL= entry points, since the 
specified FL field is placed in byte of the second word of the CLD entry. The system uses this byte in 
the CLD entry to determine field length in the following manner. 

1. If bit 11 is not set, an RFL= entry point is indicated. The field length is set to the value in byte 
of the CLD entry. 

2. If bit 11 is set (indicating a value in the CLD entry of 400000g), an MFL= entry point is 
indicated. The field length is determined in one of two ways. 

a. If bit 10 is also set, the field length is set to the maximum of the value of the last RFL 
statement and the value in byte of the CLD entry after masking off these upper 2 
bits. 

b. If bit 10 is not set, the field length is set to the maximum of the existing field length 
and the value in byte of the CLD entry after masking off these upper 2 bits. 



•DELETE DIRECTIVE 

The *DELETE directive deletes a record from the system. It cannot, however, delete a user library 
(ULIB type record). 

The format of the directive is: 

*DELETE,ty 1 /rec 1 ,ty 2 /rec 2 ,...,ty n /rec n . 

or 
♦D^yi/rec^.^tyn/recn. 

tyj/recj Record type and record name to be deleted from the system, tyj must not be 

ULIB. 
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•FILE DIRECTIVE 

The *FILE directive declares an additional file containing records to be added to the system or to 
logically replace records on the system. 

The format of the directive is: 

*FILE,filenam 

or 
*FILE,filenam,NR 

filenam Name of local file containing addition or replacement records to be placed on 

the system. File filenam is rewound before processing if NR is omitted. 



NR 



Optional parameter that inhibits rewinding of file filenam before processing. 



♦IGNORE DIRECTIVE 

The "IGNORE directive specifies that records on a replacement file are to be ignored. If no *FILE 
directive precedes an "IGNORE directive, SYSEDIT ignores the records named on this directive on the 
replacement file specified by the B control statement parameter. If one or more *FILE directives 
SnLE dir a e n ctive N ° RE dire ° tiVe ' SYSEDIT ^ nores tne re co^s on the file specified in the most recent 

The format of the directive is: 

*IGNORE,ty 1 /rec 1 ,ty 2 /rec 2 ,...,ty n /rec n . 

tyj/recj Record type and record name to be ignored on the current replacement file. 

•PPSYN DIRECTIVE 

The *PPSYN directive specifies one or more names to be synonymous with the name of an existing 
peripheral processor routine. 

The format of the directive is: 

*PPSYN,nam/nam 1 ,nam 2 ,...,nam n . 

nam Name of existing PP routine. 

nam i Additional (synonymous) name for nam. 
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RECORD TYPES 

The following record types may be specified in SYSEDIT directives. 
Type Description 

ABS Multiple entry point overlay. 

CAP Fast dynamic load capsule. 

OPL Modify old program library deck. 

OPLC Modify old program library common deck. 

OPLD Modify old program library directory. 

OVL Central processor overlay. 

PP Peripheral processor program. 

PPU Peripheral processor unit program. 

PROC CCL procedure. 

REL Relocatable central processor program. 

TEXT Unrecognizable as a program. 

ULIB User library. 
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SYSTEM FILE INITIALIZATION 



This section describes the system mechanisms used to initialize the fast-attach files used by MODVAL, 
PROFILE, RESEX, and the time-sharing subsystem. 



ISF 

The ISF control statement initializes the fast-attach system files VALIDUs, PROFILa, RSXDid, RSXVid, 
and SALVid.f A fast-attach file is a special direct access file that is initialized with the E parameter on 
the ISF control statement rather than attached with the ATTACH control statement. It is released with 
the R parameter on the ISF control statement. However, in order to release a fast-attach file, an idle 
family situation must be present. That is, the job containing the ISF(R=filenam) statement must be the 
only job in the family (family count is zero, and the direct access file count equals the number of fast 
attach files). Therefore, the DSD command, IDLEFAMILY, must be used to clear the system of all other 
jobs, and when the above conditions have been met [refer to the mass storage status display (E,M) in the 

nnor.otAT.1o niliArT\ +V>« TTM T7T? A TMTT V Amm m «n/4 m,»-.<f K« .ir.s-is4 n/tnin + /-v »11sitit +V>^ TOT? nnr.fT.nl otntnmnnt 4-~ 

v/pci aivi o uiuvkj) nit u^jLiuimuiui visiiuiicuiu iiiuoi. uc uocu again iv/ auun cue j.ui_ uuiiliui oiaicinaii iu 

be entered. The ISF command is entered via the DSD command, X., to release the fast-attach file(s). 
Refer to the NOS Operator's Guide for information about the DSD commands. 

The fast-attach file mechanism provides a method to be used by special system jobs for files which are to 
be retained as permanent files but have a high enough access rate to make permanent file ATTACHs 
excessively time-consuming. When a permanent file is activated as a fast-attach file, an FNT entry is 
made which retains the basic data normally kept in the catalog entry and system sector of the file 
(interlocks and file name). This dispenses with the catalog search and system sector read normally 
necessary to attach a permanent file. 

If the file is a shared (global) fast-attach file for a multimainframe network, additional information is 
also maintained in the FAT table on the link device. The type of file determines whether it is entered as 
global fast-attach or local fast-attach. This criterion is kept internal to ISF. Basically, VALIDUs and 
PROFILa are entered as global fast-attach files if they reside on a shared device. The resource files are 
always entered as local fast-attach. A limit of 77g exists on the number of files that can be entered as 
global fast-attach in a multimainframe environment. 

Because the fast-attach files are system files, a job containing an ISF control statement must be a 
system origin job. Processing of the statement causes a search of the system permanent file catalog 
(UI=377777) for files with the predefined names previously listed. They are defined in a table internal to 
ISF. The format of the ISF control statement is: 

E=filenam 
ISF, J R=fiienam j jFM=family,SJ=filenam,SP=filenam. 

E=filenam System file that is initialized. If E=0 or no filename is specified (neither E nor 

R appear), all files defined in the ISF table are initialized (refer to table 5-1). 



t The resource files and the terminal session recovery file (SALVid) are generated and maintained 
uniquely for each machine id in a multimainframe or single mainframe system by appending the 
machine id to the file name (for example, RSXVid becomes RSXVAB on the machine with an id of AB). 
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R=filenam Currently active system file that is released from fast-attach status. If R=0, 

all of the files in the ISF table for the specified family that are currently 
active are released. When this option is specified, an idle family situation 
(family count is zero, and the direct access file count equals the number of 
fast attach files) must first be created with the IDLEFAMILY command. 
When the family is idle, the IDLEFAMILY command must be entered again so 
that the system will accept the ISF control statement. The ISF statement is 
entered via the X. command. (Refer to the NOS Operator's Guide for 
information about the IDLEFAMILY and X. commands.) 



NOTE 



Since initialization and release are mutually 
exclusive, E and R cannot appear on the same 
control statement. 



FM=family Family of devices. If FM is not specified, the calling job's current family is 

used. The calling job's family will be restored upon exit from ISF. 

SJ=filenam Job file that ISF submits as a system origin job. The file must be an indirect 

access permanent file stored under the system user index (377777). If SJ is 
specified without =filenam, ISF assumes SJ=SYSJOB. If SJ=0 is specified, no 
job is submitted. Refer to the following note for a description of ISF 
processing when SJ is omitted. 

SP=filenam Procedure file that ISF calls with system origin. The file must be an indirect 

access permanent file stored under the system user index. If SP is specified 
without =filenam, ISF assumes SP=SYSPROC. If SP=0 is specified, no 
procedure is called. Refer to the following note for a description of ISF 
processing when SP is omitted. 



NOTE 



If the ISF control statement is entered without 
parameters, ISF searches the system user index 
(377777) of the job's family for files SYSPROC 
and SYSJOB. If SYSPROC exists, this file is 
called as a procedure file with system origin. If 
SYSJOB exists, it is submitted as a system origin 
job. If the ISF control statement is entered with 
any parameters for example, X.ISF(R=RSXDid) , 
the procedure file SYSJOB is not submitted nor is 
SYSPROC called unless specified by the SJ and/or 
SP parameter (s). 
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The automatic submission/execution of SYSJOB/SYSPROC can be used to SYSEDIT local modifications 
into the system since ISF is always executed during a level deadstart (refer to Deadstart Sequencing). 

ISF can also be entered as a command from the console via the DSD X. command (refer to the NOS 
Operator's Guide). 

The matrix in table 7-1 shows how the initialize (E) and release (R) parameters affect individual 
fast-attach files. 



TABLE 7-1. INITIALIZE AND RELEASE OF FAST-ATTACH FILES 



Name of 
Fast-Attach 
System File 


Option 


Initialize (E) 


Release (R) 


VALIDUs 
PROFILa 

RSXVid 
SALVid 


Make global fast attach. 

Make local fast attach. If the 
file does not exist in the system 
catalog (UI=377777), ISF creates 
the file and makes it a fast- 
attach file. If either RSXDid 
or RSXVid is specified, ISF 
initializes both files. 


Return from fast attach to normal 
direct access. 

Return from fast attach to normal 
direct access. If either RSXDid 
or RSXVid is specified, ISF 
returns both files to normal 
direct access. 



One use of the R option is to release fast-attach files activated on a device that is to be initialized or 
unloaded. Device initialization is not initiated as long as any direct access files are active on the device 
(an activated fast-attach file is treated the same as an active direct access file). Until these files are 
released, MSI will reply to an attempted device initialization with the error message: 

ACTIVE FILES ON DEVICE 

Similarly, a device cannot be unloaded until all its fast-attach files are released. 



DEADSTART SEQUENCING 

During a level deadstart, the PP routine SET places a job in the input queue with a queue priority of 
7777g. This job executes the PP routine CMS, whose normal functions include mass storage initialization 
and recovery. After completing these functions, CMS checks its queue priority. If the queue priority is 
7777g (indicating a deadstart sequencing call), CMS places the following control statements in its control 
statement buffer and causes the system to execute them. 

FAMILY. 
ISF. 
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The CMS deadstart sequencing job begins execution only after job processing has been enabled via the 
DSD AUTO, or MAINTENANCE, command. The job scheduler 1SJ suspends processing of all other jobs 
until the CMS job completes, thereby ensuring that all system files in the default family are initialized 
and that a SYSPROC procedure (if any) is executed before normal job processing begins (refer to ISF). 



GENVAL PROCEDURE FILE 

GENVAL is a procedure file on the system which creates a VALIDUs file containing only the system user 
index (377777 8 ) and the library user index (377776g), as well as the corresponding VALINDs file. 
GENVAL then calls ISF to make these files fast-attach files. This procedure is used immediately after a 
family device has been initialized or when running in a nonproduction environment where only one user 
index is needed. 

GENVAL can be entered from the console as follows: 
X.GENVAL. 

Before using this procedure, ensure that the user count for the family device (displayed on the E,M. 
display) is zero. 

After this procedure is completed, MODVAL can update and/or expand the files thus created. 
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The multimainframe feature provides a mechanism by which up to fourt computers may access shared 
mass storage devices. This allows the mainframes to share preserved files residing on such devices. 
Preserved files are defined as those which are retained across a level deadstart (nonsystem recovery). 
Types of preserved files are permanent files, I/O queues, and system dayfiles. 

Any combination of one to four CYBER 170 Model 171, 172, 173, 174, 175, 720, 730, 750, or 760; CYBER 
70 Model 71, 72, 73, or 74; or 6000 series mainframes may comprise a multimainframe environment. ECS 
is required with one CPU port for each mainframe. The presence of a DDP on a CPU port decreases by 
one the total number of mainframes that may run together. 

Each mainframe in a complex may operate in a multimainframe mode or in stand-alone mode; however, 
two machines may not access the same device unless both are in multimainframe mode. A device is 
considered shared if it can be accessed by more than one of the mainframes; it need not be accessible to 
all the mainframes in the complex. The 844 (single and double density) and ECS devices are the only 
devices that are supported as shared devices. 

The fact that a computer is operating as part of a multimainframe complex is not apparent to the user; 
however, there are operational changes and additions which are of importance to the operator. These 
include deadstart commands, displays, on-line commands necessary in the event of an interruption on one 
of the sharing mainframes, and the UNLOAD/MOUNT process for removable devices. 

The Mass Storage Subsystem (MSS) can be used in a multimainframe environment. However, its hardware 
components are not shared among mainframes. Rather, one mainframe is physically connected to the 
MSF and is called the master mainframe; all other mainframes are called slave mainframes. MSSEXEC 
runs on the master mainframe and is the main processing program that controls MSS activity. MSSSLV 
runs on each slave mainframe and communicates with MSSEXEC to retrieve files from MSF in response 
to ATTACH requests by jobs running on the slave mainframes. 



OVERVIEW 

ECS is used as the means and medium for controlling shared mass storage and intermainframe 
communication. Each mainframe has a CPU port into ECS through which system activity is controlled. 
In order to control shared mass storage devices, several ECS resident tables are required. The device 
access table (DAT) contains the logical description (family name/pack name and device number) of each 
mass storage device (shared or nonshared) which is accessible by any machine in the complex. For each 
device in the DAT which is to be accessed by more than one machine, a corresponding mass storage table 
(image of central memory resident MST) and track reservation table (TRT) also resides in ECS. In 
addition, a machine recovery table (MRT) exists in ECS for each machine and device (that is, there are as 
many MRTs for each shared device as there are mainframes in the complex). 



tThis feature has been designed and implemented to run on any combination of one to four mainframes. 
Due to resource limitations, the testing of this feature was conducted on one and two machine 
configurations. 
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Recovery allows a machine to either join other machines operational in a multimainframe environment or 
to operate in a stand-alone mode. The stand-alone system is not allowed to use the same mass storage 
devices as other machines. In the event of a system interruption to one machine, it is possible to operate 
the remaining machines in a multimainframe environment. 

Automatic detection of ECS is not provided because it is not possible to determine its absence and 
continue to run on all machine types. For example, a 6600 will hang if an attempt is made to execute an 
ECS instruction without ECS. ECS status is checked by CMR (SET) when called upon to process an ECS 
entry in the CMRDECK. 



DEADSTART 

A multimainframe environment is defined at deadstart by CMRDECK entries in each machine. The 
following entries are used to do this. 



CMRDECK Entry 



MID=id. 



SHARE=xxi,xx2,...,xx n . 



PRESET,n. 



LINK=xx. 



Description 

One- or two-character machine identification. This 
identification is used to associate a specific machine with its 
access to a shared device. It is required, however, even if no 
devices are shared during system operation. This id must be 
unique for each machine in the complex. (If not specified, the 
default value is MID=AA.) 

EST ordinals of the mass storage devices which will be shared 
with other machines in the multimainframe environment. The 
MST/TRT for each device resides in ECS. 

Number of devices to be shared in the complex. The PRESET 
entry must be specified on a level deadstart on the first 
machine to be deadstarted in a multimainframe environment. 
This entry initializes the flag register and ECS resident tables 
for multimainframe use. If n is not supplied, the default value 
is the number of shared devices defined for the particular 
machine. This entry can be specified only at the system console. 

EST ordinal of the equipment to be the link device. This device 
must either be of DE or DP type and cannot be defined as 
removable. The presence or absence of this entry defines 
whether the machine is to be run as part of a multimainframe 
complex or as a stand-alone system. If the LINK device is 
initialized, it must also be PRESET. is not a legal entry for 
xx. 



These entries are also described in NOS Installation Handbook. 
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Since in a multimainframe environment two or more machines can utilize the same mass storage devices, 
the device assignments and CMRDECKs of all machines are interrelated. Care must be taken to ensure 
proper -CMR-BECK settings for each machine to obtain the desired device configuration. The following 
items are important in obtaining this proper configuration. 

• Each machine must specify a unique machine identification (using the MID entry in the 
CMRDECK). This id associates a particular machine with its files on a shared device. There 
are no external characteristics associated with this identification. However, if the machine 
identification specified on a machine deadstarting into a multimainframe environment is 
identical to a machine identification on a machine already operating, the deadstart process 
halts and an appropriate message is displayed. 



• 



• 



The assignment of shared mass storage devices should be made properly to ensure the 
recoverability of the device and the proper operation of the system (refer to Shared Mass 
Storage). 

Each machine in the multimainframe environment must specify ECS as the link device, using 
the LINK CMRDECK entry. An ECS entry must also be present in the CMRDECK. If the 
CMRDECK entries are present which indicate a multimainframe environment, a check is made 
to ensure that either a DE or DP equipment entry is also present. If none is found, an error 
message is given to the operator indicating that no link device has been defined. A link device 
is automatically designated as a shared device. 

The first machine deadstarted in a complex must have the PRESET CMRDECK entry specified 
when deadstarting (level only). This command causes tables to be preset in ECS, and in so 
doing, assures that no other machine has arrived at the same point in the deadstart sequence 
and is attempting the same thing. These other machines should not have the PRESET entry 
specified during deadstart. All other machines which arrive at that point in the deadstart 
process display a message indicating that they are waiting for deadstart on the preset machine. 
A machine that does not preset ECS has no means of detecting whether ECS has been preset 
previously by another machine. Therefore, the operator must ensure that ECS has been preset 
by a prior deadstart before deadstarting a particular machine without presetting ECS. 

If ECS is initially placed in maintenance mode (half of ECS used for on-line diagnostics), the 
first machine deadstarted in a complex must have the INITIALIZE and PRESET CMRDECK 
entries specified when deadstarting (level only). The remaining machines must initialize ECS, 
because the maintenance mode parameter (MA) reduces the available ECS size by one half. 

When a mainframe joins a multimainframe complex, it is associated with an identification which it 
utilizes during system operation but which is independent of the machine id. This association is done 
during deadstart when the machine investigates the MM F tables residing on the link device and places its 
machine id in an empty slot of the four that are available. Associated with each slot is a unique machine 
index and a unique machine mask, which the machine uses either to index itself into various MMF tables 
or to identify itself in these tables. The indices are 1, 2, 3, and 4. The masks are 1, 2, 4, and 8. 

When a level recovery deadstart will be performed on one of the machines in a multimainframe 
environment, the machine recovery utility (MREC) should be performed on some or all of the remaining 
machines before the deadstart proceeds. The purpose of this utility is to clear interlocks held by the 
machine to be deadstarted which have not been cleared by CPUMTR. It can also recover mass storage 
space on a shared device that is currently not accessible because of a machine interruption (necessitating 
a level deadstart). MREC may have to be run from more than one machine since it affects only shared 
devices (that is, devices specified on the SHARE CMRDECK entry) of the machine on which MREC is 
run. If the interrupted machine shares different devices with different machines, MREC must be run 
from enough machines to account for all devices shared with the interrupted machine. The operator 
interface to MREC is described in the NOS Operator's Guide. 



• 
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Figure 8-1 generally illustrates the steps needed to deadstart a machine in a multimainframe 
environment. 

If a level 3 recovery deadstart will be performed in a multimainframe system, the ECS MMF tables must 
be intact as well as CMR. For a level 1 or 2 recovery in an MMF environment, the ECS MMF tables must 
be intact. 



SHARED MASS STORAGE 

A major reason for operating a multimainframe complex is to be able to share mass storage devices 
between machines. Thus, the users of two systems may be able to utilize the same files if these files 
reside on a shared mass storage device. Having the ability to share files between systems also means 
that several additional procedures are required when operating a multimainframe complex. Additional 
consideration must also be given when assigning mass storage. This material, which is unique to 
multimainframe operation, is discussed in the following sections. 



ASSIGNING SHARED MASS STORAGE 

Some consideration should be given as to which devices should be made shared devices and which ones 
should not. Since a shared device contains preserved files which can be accessed by more than one 
machine, it must be physically connected to and logically defined (as shared) by each machine sharing the 
device. If one device of a family is defined as shared, then normally all devices in the family should be 
defined as shared for accessibility. If a removable device will be treated as shared, it must be defined as 
removable in each machine sharing it. If a shared device is not removable, additional use of the device 
(beyond preserved files) is defined by each machine, independently of any other machine definition (that 
is, each machine must decide whether the device is to contain such things as a copy of the system or 
temporary files). 

There is no real advantage in having nonpreserved files on a shared device, unless spreading them across 
shared devices outweighs having them on a dedicated device. A key factor is drive and controller 
contention. Another factor is whether or not enough drives and accesses to those drives are available to 
warrant the spreading of temporary files across several devices from all systems. Also, additional 
overhead is incurred by the system for each shared device. This includes additional CMR space for each 
device (100 CM words) and additional time that is required to maintain the device-related tables (such as 
the MST or the TRT) in the link device (ECS). These factors must be weighed to determine how best to 
configure shared devices. 



DEVICE ACCESS TABLES 

For purposes of device usage determination, tables are maintained in ECS identifying the status of all 
devices in the multimainframe complex. This includes shared and nonshared devices for all machines. 
These tables are called the device access tables (DATs). 
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Figure 8-1. Deadstarting a Machine in an MMF Environment 
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In order to minimize configuration problems, shared removable equipment should be configured the same 
way on all machines in the complex. For example, if one system defines three shared units as three 
DI-l's and another system defines the same units as a DI-3, the first system can accommodate a DI-2 on 
these units, whereas the second system would consider it an error. Unless the configurations are the 
same on all machines, any devices mounted on those drives may not necessarily be recoverable on all 
machines. 



NOTE 



RESEX considers only the configuration of the 
machine on which it is executing in its 
over-commitment algorithm. 



MASS STORAGE RECOVERY TABLES 

One problem that is created by having more than one machine sharing a mass storage device is that of 
recovering the mass storage space and interlocks of a machine, should it require recovery processing. 
This problem is solved by defining a table which provides the information needed to recover the mass 
storage space of a machine and by having a utility which performs the recovery. The table is called the 
machine recovery table (MRT). There is one MRT for each mainframe per device. It tells which tracks 
are interlocked and which tracks are first tracks of files local to a particular machine. The MRT is 
utilized by CPUMTR on another machine to clear track interlocks and by the machine recovery utility 
MREC on another machine to recover the mass storage space of the interrupted machine. For specific 
information on the MRT, refer to the NOS Systems Programmer's Instant. 



DEVICE INITIALIZATION 

To initialize a mass storage device, it is necessary first to prevent any new activity from starting up on 
the device, then to wait until all current activity has completed, and finally to interlock the device and 
proceed with initialization. To accomplish this on shared mass storage devices in a multi mainframe 
environment, the following steps must be taken. 

1. The INITIALIZE DSD command should be entered on the machine from which the initialization 
is to take place. If it is found that the INITIALIZE command has been entered from another 
machine, an error message is displayed. Refer to NOS Operator's Guide. 

2. All other machines sharing the device must unload it by entering the UNLOAD DSD command to 
prevent any new activity. (This command can be used for both removable and nonremovable 
shared devices.) Refer to the NOS Operator's Guide and Device Unload section. 
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3. The machine from which the INITIALIZE was entered monitors the status of the other machines 
that are sharing the device. Once they have unloaded the device and user activity has ceased, 
initialization proceeds. Tables are also updated in ECS and the device is checkpointed. 

4. To activate the device on the other machines, the MOUNT DSD command must be entered from 
each machine. This command clears the UNLOAD status. If initialization is still in progress on 
another machine when a MOUNT command is entered, the MOUNT process is terminated with 
an error. Refer to the NOS Operator's Guide. 



DEVICE UNLOAD 

In a multimainframe environment, unloading a device involves more than it does under a one machine 
system. A device can be unloaded from a machine (referred to as a local unload), or it can be unloaded 
from the entire multimainframe complex (referred to as a global unload). A device can be physically 
removed from the complex only after a global unload has been accomplished. The general procedure to 
complete a global unload is illustrated in the following. 

1. Enter the UNLOAD command from each machine. This is an indication to the machine that no 
new accesses should be initiated. This command must be entered from each machine sharing 
the device. 

2. When all local unloads are set and user access has ceased, global unload status is set if the 
device is a removable device. This global unload status is displayed on all machines, indicating 
that there is no activity on the device from any machine and that the device may be physically 
unloaded. 

3. The operator can then switch packs and enter the MOUNT command at the console to initiate 
recovery of the device. The MOUNT command clears the global unload status and the local 
unload status on the machine from which it was entered and indicates that this machine is now 
accessing the device. All other machines continue to ignore the device until the MOUNT 
command is entered on each machine. The MOUNT command does nothing if local unload status 
is not set on the machine. 



DEVICE RECOVERY 

Deadstart and on-line recovery methods are similar logic in recovering mass storage devices. When a 
device is recovered, the DAT in ECS is interlocked while a check is made to see if an entry exists for this 
device. The presence of an entry indicates that another machine is also accessing the device. If an entry 
is found, and the machine recovering the device has not been instructed to share it, an error is indicated 
and recovery halts with an appropriate message displayed. If the machine already accessing the device is 
not allowing it to be shared, the same error condition occurs. Therefore, if a device is being accessed, 
another machine can recover that device only if the recovering machine and the accessing machine use 
the device in shared mode. 



NOTE 



If two devices recovered on separate machines 
have the same family name/device number or 
pack name, there is no method of determining 
whether or not they are the same device if both 
are shared. If they are different devices, they are 
both destroyed when used. 
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DEVICE CHECKPOINT 

Local MST information for each machine which shares a mass storage device is maintained on the 
device. MST information for other machines may also be present on the device. The information for 
each machine is kept in one sector on the label track following the TRT sectors. Entries up to 31 unique 
machine ids can exit. 

During checkpoint, only the local MST information of the machine performing the checkpoint is updated. 
Since local MST information for many machines is kept on the device, updating of all these areas by one 
machine could cause a loss of information needed if the device were to be used with another system. 

For shared devices, duplication of checkpointing by more than one machine is prevented. If a machine 
attempts to checkpoint a shared device and determines that another machine is performing the 
checkpoint (a checkpoint request bit is set in the local MST area of another machine), no action is taken. 
Only one checkpoint bit is set at any given time for a device. 



MULTIMAINFRAME OPERATION IN AN MSS ENVIRONMENT 

MSS processing is available in a multimainframe environment. Unlike other mass storage devices (disk 
and ECS), however, the MSF is not shared by mainframes. Rather, MSF is physiclly connected to and 
driven by one mainframe, called the master mainframe. All other mainframes that share permanent files 
with the master mainframe are called slave mainframes. The disks to which MSF resident files are to be 
staged must be shared devices and accessible by all mainframes. 

MSSEXEC runs on the master mainframe and is the main program that controls MSS processing 
activities. MSSEXEC is activated via the following commands that are entered at the system console.t 

ENABLE=MSS MASTER 
n.MSSffff 

MSSSLV runs on each slave mainframe and is the program that supports file retrieval from MSF for jobs 
running on a slave mainframe. MSSSLV is activated via the following commands that are entered at the 
system console.t 

DISABLE=MSS MASTER 
n.MSSffff 

When a job running on a slave mainframe attaches an MSF-resident file that has no disk image, MSSSLV is 
requested to stage the file to disk. However, MSSSLV cannot access MSF directly. MSSSLV must 
communicate with MSSEXEC, which stages the file to shared disk and then notifies MSSSLV when the file 
is available. MSSSLV then causes the requesting job to be resumed so that the file ATTACH can complete. 

The permanent files used for communication between MSSEXEC and MSSSLV are initialized and 
recovered automatically and require no backup or recovery processing by the installation. The name of 
the permanent file used by MSSSLV running on mainframe i (i=l, 2, 3, 4) to send requests to MSSEXEC is 
STOMNOi. The name of the permanent file used by MSSEXEC to respond to all requests by all MSSSLVs 
is MTOSPFN. These files belong to the family that contains ECS and are saved under the user index 
377760 8 . 



t Refer to the NOS Operator's Guide for more information about these commands. 
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580 PROGRAMMABLE FORMAT CONTROL 



Spacing and format control is provided by the use of carriage control format tapes or programmable 
format control (PFC) on 580 line printers. The carriage control format tape is punched to indicate 
particular format channels for each frame. A printer with PFC does not use carriage control format 
tapes; instead, it contains a microprocessor plus memory. PFC arrays are loaded into this memory, 
performing the same function as the format tape. This section describes the creation and loading of PFC 
arrays. A description of format tapes may be found in volume 1 of the NOS Reference Manual. 



PFC ARRAYS 

Certain 580 printers are not equipped with a carriage control tape; instead, a microprocessor plus 
memory referred to as PFC is used. Instead of a tape controlling the page format, software is used. This 
software is referred to as a PFC array. A PFC array consists of numbers from to 17g. Each nonzero 
character represents a channel. A zero specifies that no channel is selected. An array is similar to a 
xorrnat tape since each number in a PFC array corresponds to a line on the print form. As each line of a 
page is printed, the next number in the PFC array buffer is addressed. A carriage control character in 
column 1 of the output line, indicating a skip to a particular channel, causes the memory in the PFC 
array buffer to be sequentially addressed until the particular number is found. The paper is spaced a 
similar number of spaces. 

A PFC array differs from a format tape because only one channel can be specified per line. A number of 
channels can be specified per line using a format tape. Also, PFC arrays are accessed in pairs, one for 6 
lines per inch printing and one for 8 lines per inch printing. The 8 lines per inch array is usually larger, 
allowing more lines to be printed on the same size page. 



BUILDING PFC ARRAYS 

Observe the following rules when building a PFC array. 

1. Enter only valid numbers (0 through 17g) in the PFC array. 

2. A 1 must be the first number in the PFC array, indicating a top of form position. 

3. A 12g should always indicate the last line of the form (bottom of page). 

4. A 17g should appear as the last number in the array, denoting the end of valid numbers for a 
given array. This number does not correspond to any particular line on the form. 

5. Maximum length PFC arrays (132 for 6 lines per inch and 176 for 8 lines per inch) must include a 
9 only at location 132 for 6 lines per inch and location 176 for 8 lines per inch. Improper paper 
alignment may occur if a 9 is placed elsewhere. 
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To properly load the appropriate PFC buffer for a particular form, it is necessary to assemble data that 
will contain, when transmitted and stored in the PFC array buffer, as many numbers as lines on the 
form. As stored within the PFC array buffer, each number is a 4-bit code used to represent channels (1 
through 14) or a null code (no channel selected). 



NOTE 



Channels 13 and 14 are valid channels but are not 
selectable. No PFC error occurs when loading 
these numbers into the PFC buffer. 



The maximum capacity of the 6-line per inch PFC buffer is 132 numbers (22-inch form maximum) plus 
the last line number whereas the 8-line per inch PFC buffer has a capacity of 176 numbers (22-inch form 
maximum) plus the last line number. Fewer than the maximum amount of numbers may be legally loaded 
into the PFC buffer, but an excessive amount of numbers will cause a PFC overflow error. 



ADDING PFC ARRAYS 

PFC arrays must occur in pairs (one 6-line per inch array and one 8-line per inch array); therefore, when 
a particular array is specified with the SC option of the ROUTE control statement, it is possible to 
switch from 6 to 8 lines per inch spacing. Two pairs of arrays are provided with the operating system 
(table 9-1). 

To add additional PFC arrays, BATCHIO must be modified to contain these additional arrays as overlays 
in QAP. The overlay names and corresponding ROUTE statement SC parameter options must be added to 
PFCO, and PFC overlay table in QAP. The first entry in this table indicates the default PFC array. This 
array is used when the SC parameter is not specified. If an added array is to be the default array, the 
PFCO entry for it should be placed at the beginning of the table. The value which must be specified with 
the SC parameter is included in this entry. This value can be any 6-bit binary value. The arrays that are 
also added to QAP must follow the same format, structure, and labeling conventions as the arrays 
already provided in QAP. 

To generate the numbers to be loaded into the PFC buffer, the DPFC (define PFC code) macro is used 
with the following format. Only the lower 4 bits of each 6 bits are used as PFC numbers. 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




DPFC 


a,b,c,d 



a, b, c, d 



PFC numbers for 6 or 8 lines per inch. These numbers can be any value from 
to 17s- 
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NOTE 

In each macro call, all four parameters must be 
specified (0 denotes no channel is selected). If all 
four are not required to complete an array (the 
number of lines on the form is not a multiple of 
4), zeros should be used for the remaining 
parameters. 



TABLE 9-1. RELEASED PFC ARRAYS 





6 lpi 


6 lpi 


8 lpi 


8 lpi 




6 lpi 


6 lpi 


8 lpi 


8 lpi 


Location 


Def 


Alt 


Def 


Alt 


Location 


Def 


Alt 


Def 


Alt 


1 


1 


1 


1 


1 


41 








3 


3 


2 


O 


6 


6 


6 


42 














3 














43 


3 


8 








4 


2 


2 








44 














5 








2 


2 


45 








4 


4 


a 


n 


n 


rt 


n 












o 


u 


U 


U 


u 


4D 


4 


10 








7 


3 


3 








47 














8 














48 














9 








3 


3 


49 


5 


11 


5 


5 


10 


4 


4 








50 














11 














51 














12 














52 


2 


2 








13 


5 


5 


4 


4 


53 








2 


7 


14 














54 














15 














55 


3 


3 








16 


2 


7 








56 














17 








5 


5 


57 








3 


8 


18 














58 


4 


4 








19 


3 


8 








59 














20 














60 














21 








2 


7 


61 


5 


5 


4 


10 


22 


4 


10 








62 














23 














63 














24 














64 


12 


12 








25 


5 


11 


3 


8 


65 








5 


11 


26 














66 














27 














67 


1 


1 








28 


2 


2 








68 














29 








4 


10 


69 








2 


2 


30 














70 


2 


2 








31 


3 


3 








71 














32 














72 














33 








5 


11 


73 


3 


3 


3 


3 


34 


4 


4 








74 














35 














75 














36 














76 


4 


4 








37 


5 


5 


2 


2 


77 








4 


4 


38 














78 














39 














79 


5 


5 








40 


2 


7 








80 
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TABLE 9-1. RELEASED PFC ARRAYS (Contd) 





6 lpi 


6 lpi 


8 lpi 


8 lpi 




6 lpi 


6 lpi 


8 lpi 


8 lpi 


Location 


Def 


Alt 


Def 


Alt 


Location 


Def 


Alt 


Def 


Alt 


81 








5 


5 


125 








2 


2 


82 


2 


7 








126 














83 














127 


5 


5 








84 














128 














85 


3 


8 


12 


12 


129 








3 


3 


86 














130 


12 


12 








87 














131 














88 


4 


10 








132 


9 


9 








89 








1 


1 


133 


178 


17 8 


4 


4 


90 














134 












91 


5 


11 








135 












92 














136 












93 








2 


2 


137 






5 


5 


94 


2 


2 








138 












95 














139 












96 














140 












97 


3 


3 


3 


3 


141 






2 


7 


98 














142 












99 














143 












100 


4 


4 








144 












101 








4 


4 


145 






3 


8 


102 














146 












103 


5 


5 








147 












104 














148 












105 








5 


5 


149 






4 


10 


106 


2 


7 








150 












107 














151 












108 














152 












109 


3 


8 


2 


7 


153 






5 


11 


110 














154 












111 














155 












112 


4 


10 








156 












113 








3 


8 


157 






2 


2 


114 














158 












115 


5 


11 








159 












116 














160 












117 








4 


10 


161 






3 


3 


118 


2 


2 








162 












119 














163 












120 














164 












121 


3 


3 


5 


11 


165 






4 


4 


122 














166 












123 














167 












124 


4 


4 








168 
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TABLE 9-1. RELEASED PFC ARRAYS (Contd) 



Location 


6 lpi 
Def 


6 lpi 
Alt 


8 lpi 
Def 


8 lpi 
Alt 


Location 


6 lpi 
Def 


6 lpi 
Alt 


8 lpi 
Def 


8 lpi 
Alt 


169 
170 
171 
172 
173 






5 



12 


5 



12 


174 
175 
176 
177 








9 

178 




9 
178 


Notes: All values are decimal unless indicated otherwise. 












lpi Lines per inch 












Def Default (SC=0) 












Alt Alternate (SC=1) 
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EXPRESS DEADSTART DUMP INTERPRETER 10 



The deadstart dump interpreter (DSDI) is a utility program, called by a batch control statement, which 
converts selected portions of the binary information on an express deadstart dump (EDD) file into reports 
to be listed. The express deadstart dump file is generated on magnetic tape by the express deadstart 
dump utility which may be run at deadstart time after a system malfunction has occurred. Information 
on the EDD file is sequenced according to the illustration in figure 10-1. Refer to the NOS Operator's 
Guide for complete information concerning the use of EDD. 

Selection of data to be listed by DSDI is provided through input directives, either on an input file or on 
the DSDI control statement itself. Normal octal dumps of CM, ECS, and PP memory can be produced by 
these directives as well as specially formatted dumps of specific system tables and buffers. 

The following features are provided through the use of EDD and DSDI. 

• The EDD tape file contains a dump of memory, the executing exchange packages, the CDC 
CYBER 170 S/C registers, where applicable, and all PPs except for PPO which can be saved by 
eitner copying it to anotner PP or by biasing the PP switch on the deadstart panel, u the 
hardware exists. EDD can optionally dump all or part of ECS and the selected buffer 
controllers. This permits analysis of a system malfunction to be performed entirely off-line. 

• Because DSDI copies the EDD file to a word-addressable random file on mass storage, dump 
data can be accessed in any order. 

• EDD requires only a small amount of time during deadstart because the data is transferred in 
binary form to magnetic tape. 

• The tape file created by EDD can be retained on magnetic tape or mass storage until it is no 
longer needed. Thus, a selective listing can be generated at any time. 

• General information from the EDD file appears in the title and subtitle line of each page of 
listed output. The first 50 columns of each input directive are included in the title line of the 
output list it produces. An input directive is provided which enables insertion of comments into 
the subtitle line. 

• Use of DSDI is possible from an interactive terminal as well as from the batch environment. 
The output produced by several directives is formatted for terminal output (72 columns). From 
a batch environment, output is formatted for a 136-column printer. 
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Status /Control 

Registers 
(CYBER 170 only) 



PPUs 



CM 



CPU hardware 
registers from 
deadstart time 



ECS 
(if dumped) 



*SCR* 


I 


EXPRESS nn 









-E0R- 



*SC16* 



-EQR- 



*SC36* 



-EOR- 



*PP00* 

PPOO MEMORY 



-EOR- 



*PP01*_ 

PP01 MEMORY 



-EOR- 



*PPnn* 

PPnn MEMORY 



-EOR- 



-EOR- 



CM CONTENTS 



*CPR* 



EXPRESS nn 



-EOR- 



*CPU0* 



-EOR- 



*CPU1* 



-EOR- 



*ECS* __FR 
EXPRESS nn 



-EOR- 



ECS CONTENTS 



-EOF- 



- 


EOR- 


*pp* 


EXPRESS 


nn 







*gm* 


size 


EXPRESS nn 







I - Bit set if I (ignore error) deadstart option selected 
mi = dump identifier 



One word header for channel 16 Status /Control register 



One word header for channel 36 Status /Control register, 
if it exists 



nn = dump identifier 



One word header for first PPU 



One word header for second PPU 



One record for each PPU 
nn=last PPU number 



size = CM size/1000 
nn = durap identifier 



nn = dump identifier 



F - Bit set in CPUO header word if CPUO turned off 
20B word exchange package executing at deadstart 

F - Bit set in CPU1 header word if CPU1 turned off. 
This record exists only if two CPUs exist or CPUO is 
turned off 

FR - ECS flag register, size = ECS size dumped/1000 
nn = dump identifier 



Figure 10-1. EDD Tape Format 
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CALLING THE EXPRESS DEADSTART INTERPRETER 

Processing of the EDD file is initiated with the DSDI control statement. The format of the statement is: 

DSDI(p 1 ,p 2 v.,Pn) 

where pj is either a keyword or a keyword equated to a value. All keywords are optional and order 
independent. If a keyword is not specified, a default value is assumed. 



Pi 
D 

D omitted 
F=filenam 

F omitted 
I = filenam 
I omitted 
L=filenam 

L omitted 

NR 

NR omitted 

P 



P omitted 

PD=n 

PD 

PD omitted 



Description 

Random dump file is to be created. This file can then be used as the dump 
file on subsequent executions of DSDI, eliminating the need to read the entire 
dump tape on each call. 

No random dump file is to be created. 

One- to seven-character name of file on which the express dump is to be 
written. 

Same as F=DUMP. 



flno- tr» cm/on— nhavant&r' no mo r»f filo r>n whif»h inniit dir»or»tivp<3 arp writtpn. 

Same as I=INPUT. 

One- to seven-character name of file on which list output is to be written. 
User must save or print the file. 

Same as L=OUTPUT, except that the file is automatically printed. 

EDD file is not to be rewound. 

EDD file is to be rewound before processing. 

Low core pointers from running system are to be used. Selecting this option 
causes the low core pointers from the running system to be used to locate 
tables and buffer areas on the EDD file. This option is typically used when it 
is known that the low core pointers on the EDD file were destroyed by the 
system malfunction (for example, a CPUMTR error exit leaves an exchange 
package in memory locations through 20 octal). Directives used to dump 
low core will dump the low core pointers contained on the EDD file, not those 
from the running system. 

This option should be used only when the configuration of the running system 
is the same as the system in use when the EDD file was created. 

Low core pointers from EDD file are to be used. 

Print density in number of lines per inch (3, 4, 6, or 8). 

Same as PD=8. 

Same as PD=6. 
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Pi Description 

Z Input directives are contained on the control statement after the terminator. 

The I option is ignored. This eliminates the need to use a separate input file 
for the directives when only a few directives are needed. 

Z omitted Input directives are not contained on the control statement. The system uses 

the I option. 

When input directives appear on the DSDI control statement, the first 
character following the control statement terminator is the separator 
character for all directives on the control statement. Any display code 
character which is not used in any of the directives, including a space, can be 
used as the separator character. Each directive must be preceded by a 
separator and terminated by a period. The directives can extend to column 
72 on the statement. Continuation cards are not permitted. 

For example, (slant bar used for separator): 

DSDI(Z)/SC./XP./P./D,0,20000./EC./D,0,10000. 

If the directives are included in the input file, the following equivalent job 
would appear. 

DSDI. 

- -EOR- - 

SC. Dump CYBER 170 S/C register. 

XP. Dump executing exchange packages. 

P. Dump aD PPs. 

D,0,20000. Dump the first 20000 octal locations of CM. 

EC. Set memory type to ECS. 

D,0,10000. Dump the first 10000 octal locations of ECS. 

- -EOI- - 

A request for the EDD tape must precede the DSDI control statement. Since EDD writes information on 
an unlabeled, seven- or nine-track tape at a density of 800 bpi for seven-track and 1600 cpi for 
nine-track, the request should appear as follows: 

LABEL(DUMP,D= ( 1600 I f NT |,F=S,LB=KU,VSN=DUMP) 
1 800 I |MTJ 

It is recommended that the vsn parameter be specified in the request. If this is done, the request is 
presented in the resource mounting preview display and the job is rolled out until the tape is mounted and 
assigned. Although the default express dump file name (DUMP) is used in this example, a different file 
name can be specified, provided the same file name is also specified on the DSDI control statement (F 
option). 
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INPUT DIRECTIVES 

DSDI input directives provide the capability to selectively dump only those portions of the EDD file that 
are of interest. The input directives are grouped into the following categories. 

• List Control Directives. 

Allow user to control line printer page eject and print density, and to specify comments in 
subtitle line of the output listing. 

• File Manipulation and Control Directives. 

Allow user to specify alternate files for DSDI input directives and listing output. 

• CM/ECS Dump Directives. 

Provide octal dumps of specified portion of central memory or ECS. Absolute or relative 
addresses can be dumped (three dump formats are available). 

• PP Dump Directives. 

Provide octal memory dumps of all or selected PPs (two dump formats are available). PP 

c\*^*\l»T<r»^« jAr\+r\ s&mt r%/\ i try *%\ 1 1 ^4 r% jH i r* f n« Hurvk v\n 

CLiiGLxyaio vjclcgl v;cui uo mv;xuvjo\a m cue; viuiupo* 

• CMR Dump Directives. 

Provide specially formatted dumps of selected areas in central memory resident. These areas 
are specified by name rather than by address. 

• Subsystem Dump/ Analysis Directives. 

Provide specially formatted dumps of subsystem control points and associated tables and buffers. 

• Hardware Register Dump Directives. 

Provide dumps of specified hardware registers. 

Several of the DSDI input directives have interactive capabilities. The output produced by these 
directives is specially formatted for listing at an interactive terminal. Refer to Interactive Use of DSDI 
(later in this section) for information concerning directive entry and use of DSDI from an interactive 
terminal. 

Printer Output Listing Examples contains examples of listings produced by several of the DSDI input 
directives. 
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DIRECTIVE FORMAT 

A directive has the following format, t 



/DIRECTIVE 
HAME 



Pi 




COMMENTS 



Directive Name 
Separator 



Pi 



Terminator 



The directive name starts in column 1. It is terminated by a separator or 
terminator character. 

Any character, including a space, other than the following. 
A-Z, 0-9, +, -, * 

A period is the directive terminator; therefore, it cannot be used as a 
separator. 

Parameter option for the directive. Depending on the requirements of the 
directive, the directive may have no parameters or a number of parameters. 
Directives which do not process parameters will ignore everything beyond the 
first separator. Directives which require a fixed number of parameters will 
ignore everything beyond the separator for the last legal parameter. 

The explicit directive terminator is a period. Anything beyond the period is 
ignored. 

Any characters following the directive terminator are considered comments 
and are ignored by DSDI. However, the comments are included with the 
directive in the title line of each page of the output listing (combined total of 
50 characters appear in the listing). 



tAlthough the directive format shown illustrates a directive as it would appear in a batch job deck, the 
same format is used when directives are stored on a file or entered from an interactive term'inal. 
Refer to Interactive Use of DSDI for additional information concerning directive entry from an 
interactive terminal. 
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LIST CONTROL DIRECTIVES 

The list control-, directives provide the capability to specify print . density and page eject options, and to 
add comments in the subtitle line of each page listed. 



EJON — Turn On Auto Page Eject 

The EJON directive enables auto page eject (default condition). DSDI automatically issues a page eject 
function before listing the output produced by each new directive processed. This directive has no effect 
unless auto page eject has been disabled by the EJOFF directive. 

Format: 

EJON. 



EJOFF — Turn Off Auto Page Eject 

The EJOFF directive disables auto page eject. Until this directive is processed, DSDI automatically 

ioou^o tt ^ragv. tjcv/i luuuuuu uciuic liaLiiig luc uuL^ui |jruuuccu uy eacn new uirecuve. 

Format: 
EJOFF. 



EJ — Force Page Eject 

The EJ directive forces DSDI to issue a page eject function before listing the output produced by the 
next directive processed. The EJ directive can also force a page eject upon reaching a specified point on 
the page being printed. The page eject function is performed automatically unless disabled by the EJOFF 
directive. 

Format: 

EJ,nn. 

nn Force page eject only if less than nn decimal lines remain on the current 

page. If nn is omitted, page eject is forced before listing the output from the 
next directive processed. 



PD — Reset Print Line Density 

The PD directive resets the print line density to a value other than that specified on the DSDI control 
statement. 

Format: 

PD,n. 

n n is new print line density in number of lines per inch (3, 4, 6, or 8). If n is 

omitted or an illegal value is specified, the message ILLEGAL PRINT 
DENSITY SELECTION is issued. 
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*. — Comment in Subtitle Line 

The *. directive specifies a comment that appears in the subtitle line of each page listed. 

Format: 

♦.CCC...CCC 

ecc.ecc Comment (up to 36 characters are printed). 

FILE MANIPULATION AND CONTROL DIRECTIVES 

File manipulation and control directives provide the capability to specify alternate files for DSDI input 
directives and listing output. 



READ 



Read Alternate Directives File 



The READ directive causes DSDI to temporarily stop reading the current directives file and begin 
reading directives from the specified record on the named alternate file or from current position if the 
record name is omitted. DSDI reads from the specified alternate directives file until an end of record is 
encountered (end of file or empty record if * is specified) and then resumes with the next directive on 
the original input directives file. 

Format: 

READ,filenam. 

READ,filenam,rec. 

READ,filenam,*. 

filenam Name of alternate directives file (local file). 

rec Optional record name. If rec is specified, file filenam is searched for record 

rec from the current position to end-of-file or an empty record. If rec is not 
found, DSDI issues an error message. If rec is not specified, DSDI reads 
directives from the current position to end of record. Records must be in 
text format where the first word of the record is the record name, unless the 
file is assigned to an interactive terminal; then, directives may be entered 
directly. 

* Optional character which specifies that DSDI is to read directives from all 

records until an end-of-file or an empty record is encountered. 
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OUTPUT — Assign Output to Alternate List File 

The OUTPUT directive temporarily assigns DSDI listing output* 'to a file other than that specified on the 
DSDI control statement. When the alternate file is disposed to the print queue (refer to DISPOSE 
directive), output resumes on the original output file. If the alternate file is not disposed, both the 
original and the alternate output files remain at the job control point as local files. Refer to Interactive 
Use of DSDI for additional information concerning use of this directive from an interactive terminal. 

Format: 

OUTPUT,filenam. 

filenam Name of alternate list file (one to seven characters). Only one alternate 

output file may be active at a time; filenam cannot be the same name as the 
normal output file. If filenam is omitted, the system assumes file name 
ALTRNT. 



DISPOSE — Dispose Alternate List File to Print Queue 

The DISPOSE directive causes the alternate list file specified by the OUTPUT directive to be disposed to 
the print queue. DSDI listing output then resumes on the original output file. This directive has no 
effect unless output has previously been assigned to an alternate list file (refer to OUTPUT directive). 
Refer to Interactive Use of DSDI for additional information concerning use of this directive from an 
interactive terminal. 

Format: 

DISPOSE,usernum. 

usernum User number under which the remote batch terminal to receive listing is 

logged in. If usernum is omitted, the listing is printed at a central site line 
printer. 



REWIND — Rewind File 

The REWIND directive repositions the specified file to beginning-of-information. 
Format: 

REWIND,filenam. 

filenam Name of file to be rewound. 

CM/ECS DUMP DIRECTIVES 

The CM/ECS dump directives provide the capability to dump any portion of central memory or extended 
core storage in instruction parcel, byte, or word format. Display code character equivalents are included 
with each format. Either absolute or relative memory locations may be dumped. Refer to CMR Dump 
Directives for directives used to dump specific portions of NOS central memory resident (CMR). 
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Dump Control Directives 

Dump control directives select the type of memory to be dumped (CM or ECS) and the addressing mode 
to be used (absolute or relative). 



CM - Set Memory Type to CM 



The CM directive specifies that subsequent C, D, and E directives dump central memory locations. 
Unless the EC directive is specified, central memory locations are dumped by default. 

Format: 

CM. 



EC - Set Memory Type to ECS 

The EC directive specifies that subsequent C, D, and E directives dump extended core storage (ECS) 
locations. Unless this directive is specified, central memory locations are dumped by default. 

Format: 

EC. 



RA - Reset Reference Address 

The RA directive specifies that subsequent C, D, and E directives dump memory locations relative to a 
specified reference address. Unless the RA or RAC directive is entered, absolute memory locations are 
dumped by default. 

Format: 

RA,nnnnnnn. 

nnnnnnn Reference address; addresses specified on subsequent C, D, and E directives are 

relative to this address. 

Clearing the reference address specified on the most recent RA or RAC directive reenables absolute 
addressing. This is done by entering the RA directive in the following format. 

RA,0. 



RAC - Reset Reference Address to RA of Control Point 



The RAC directive specifies that subsequent C, D, and E directives dump memory locations relative to 
the reference address of a specified control point. Unless the RA or RAC directive is entered, absolute 
memory locations are dumped by default. 
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Format: 

R AC, nn. 
nn 



Control point number; addresses specified on subsequent C, D, and E 
directives are relative to the reference address of this control point. 



Refer to the description of the RA directive to reenable absolute addressing. 



Memory Dump Directives 

Memory dump directives specify the area of memory to be dumped and determine the format of the 
output listing (refer to Printer Output Listing Examples for sample output listing). The CM and EC 
directives determine the type of memory to be dumped (default is central memory). Absolute memory 
locations are dumped unless relative addressing har been enabled (refer to RA and RAC directives). 



C - Dump Memory in Instruction Parcel Format 



The C directive causes the specified locations of central memory or ECS to be dumped in iour groups 01 
five octal digits (three words per line) with display code character equivalents. Repetitive data is 
suppressed. 

Format: 

C,fwa,lwa. 

fwa First-word address to be dumped (mandatory). 

lwa Last-word address, plus one location, to be dumped. If lwa is omitted, fwa+1 

is assumed by default. 

The output listing is read from top to bottom by column rather than across the page. Refer to 
Interactive Use of DSDI for additional information concerning use of this directive from an interactive 
terminal. 



D - Dump Memory in Byte Format 

The D directive causes the specified locations of central memory or ECS to be dumped in five groups of 
four octal digits (three words per line) with display code character equivalents. Repetitive data is 
suppressed. 

Format: 



D,fwa,lwa. 
fwa 
lwa 



First-word address to be dumped (mandatory). 

Last-word address, plus one location, to be dumped. If lwa is omitted, fwa+1 
is assumed by default. 
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The output listing is read from top to bottom by column rather than across the page. Refer to 
Interactive Use of DSDI for additional information concerning use of this directive from an interactive 
terminal. 



E - Dump Memory in Word Format 

The E directive causes the specified locations in central memory or ECS to be dumped in word format 
(four words per line) with display code character equivalents. 

Format: 

E,fwa,lwa. 

fwa First-word address to be dumped (mandatory). 

lwa Last-word address, plus one location, to be dumped. If lwa is omitted, fwa+1 

is assumed by default. 



PP DUMP DIRECTIVES 

PP dump directives provide the capability to obtain a memory dump of all or selected PPs. Two dump 
formats are available, block format and line format. 



P — Dump PP Memory in Block Format 

The P directive causes PP memory to be dumped in block format where each block represents 100 octal 
words of memory. The blocks are read by column (top to bottom), where each column contains 10 octal 
12-bit words numbered through 7. There are 10 octal columns in each block, numbered through 7. 
Repetitive data is not suppressed and zero words are represented by hyphens ( ). 

Format: 

p » n l,n2»... ,n n . 

n\ Number of PP to be dumped. If omitted, all PPs are dumped. 



PF — Dump FLPPtMemory in Block Format 

The PF directive causes first level peripheral processor (FLPP) memory to be dumped in block format 
where each block represents 100 octal words of memory. The blocks are read by column (top to bottom), 
where each column contains 10 octal 12-bit words numbered through 7. There are 10 octal columns in 
each block, numbered through 7. Repetitive data is not suppressed and zero words are represented by 
hyphens ( ). 



tHardware manuals define peripheral processors making up a peripheral processor subsystem (PPS) as 
PPs and the first level peripheral processors as PPUs. In this manual, first level peripheral processors 
are referred to as FLPPs. FLPPs are available only on the CYBER 170 model 176. 
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Format: 

PF, ni ,n 2 ,...,n n . 



Number of FLPP to be dumped. If omitted, all FLPPs are dumped. 



q — Dump PPU Memory in Line Format 

The Q directive causes PP memory to be dumped in line format with display code character equivalents. 
Each line contains 20 octal bytes (PP words) printed in two sets of 10 octal bytes. Each set consists of an 
address, 10 octal bytes, and display code character equivalents. Repetitive lines are suppressed and zero 

bytes are represented by hyphens ( ). Refer to Interactive Use of DSDI for additional information 

concerning use of this directive from an interactive terminal. 

Format: 

Q,n 1; n2,...,n n . 

nj Number of PP to be dumped. If omitted, all PPs are dumped. 

QF — Dump FLPPt Memory in Line Format 

The QF directive causes FLPP memory to be dumped in line format with display code equivalents. Each 
line contains 20 octal bytes printed in two sets of 10 octal bytes. Each set consists of an address, 10 
octal data bytes, and 16 display code equivalents. Repetitive lines are suppressed and zero bytes are 
represented by hyphens ( ). 

Format: 

QF,n 1 ,n 2 ,...,n n . 

nj Number of FLPP to be dumped. If omitted, all FLPPs are dumped. 

AP — Dump Analysis of PPand PP Memory in Line Format 

The AP directive causes PP memory to be dumped in line format with display code character equivalew 
(same format as Q directive). Repetitive lines are suppressed and zero bytes are represented by 
hyphens. An analysis of the PP is printed before the memory dump. Analysis data includes the 
associated PP communications area, resident entry point call addresses, and read-only variables in 
directive cells. Certain direct cell variables are verified and those in error are indicated. 



t Hardware manuals define peripheral processors making up a peripheral processor subsystem (PPS) as 
PPs and the first level peripheral processors as PPUs. In this manual, first level peripheral processors 
are referred to as FLPPs. FLPPs are available only on the CYBER 170 model 176. 
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Correct operation of this directive requires that 
the PP communication area on the EDD file be 
intact. 



Format: 

AP,n!,n 2 ,...,n n . 

n i Number of PP to be dumped or a program name. If a program name is 

specified, all PPs executing that program are dumped. A warning message is 
issued if an illegal number is specified or the program name is not found in 
any PP. If nj is omitted, all active PPs are dumped. 

Refer to Printer Output Listing Examples for a sample of the printer output listing produced by this 
directive. 



MPP — Move PP 

The MPP directive causes the correct logical PP to be dumped if the logical position of PPOO has been 
changed prior to the full dump to tape. If the PPS-O/PPS-1 toggle switch has been toggled, the first 
format should be specified. If PPOO has to be moved to another PP via a deadstart panel program, the 
second format should be specified. 

Formats: 

MPP. (This format is meaningful only on CYBER 170 and CYBER 70 Systems with 

20 PPs.) 

MPP,n. 

n Number of PP to which PPOO was moved, n cannot equal 0. 



PMS — Read PP Select Switches 

The PMS directive causes the dump of the S/C register to be read to determine the current value of the 
PP memory select switches and the correct logical PP to be dumped, if the logical position of PPOO has 
been changed prior to the full dump to tape. If the PP memory select switches have been changed, this 
directive should be specified with the binary value of the switches prior to the change. This directive is 
meaningful only on a CYBER 170 system. 

Format: 

PMS,n. 

n Previous select switch setting; 0-llg. If n is the same value as that read 

from the S/C register, this directive is not meaningful. 
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CMR DUMP DIRECTIVES 

The CMR dump directives provide the capability to selectively dump specified areas of central memory 
resident. Refer to the NOS Systems Programmer's Instant for detailed illustrations of central memory 
resident. 

Successful use of the CMR dump directives is dependent upon the integrity of central memory at the 
time EDD was performed. Most important is the integrity of the low core pointers on the EDD file. If 
these pointers are not intact, the dump produced by DSDI may prove meaningless. Thus, if it is suspected 
that the low core pointers are not intact, specifying the P keyword on the DSDI control statement allows 
DSDI to use the low core pointers from the running system. This option should only be used when the 
configuration of the running system is the same as the system in use at the time the EDD file was 
created. If the low core pointers on the EDD file are not intact, the integrity of the other areas of 
central memory is also questionable. In this case, the output produced by the CMR dump directives may 
be unpredictable. 



LC — Dump Low Central Memory 

The LC directive causes DSDI to dump the contents of low central memory (that is, central memory 
locations through 177 octal). Each word is divided into the appropriate parameter fields. Each field is 

llStPd nil n <SPnflT»«tO linO With a HaC/wintinn n? 4-V>rt nn.nmnfn. T>U-^ „1 I.,*- ~JJ I J." 1 1_ 

— _ „„£,„«.„« „»»« ,,**,» vi uCovi lyuvu ui me pcu. cuuccci . i lie ausuiuic auurcss euiu cuspiay coae 

character equivalents are also listed for each word. 
Format: 
LC. 



CP — Dump Active Control Point Areas 

The CP directive causes all active control point areas, or a selected subset, to be dumped. List options 
provide the ability to dump only desired portions of the control point area and other control point related 
data. Refer to Interactive Use of DSDI for additional information concerning use of this directive from 
an interactive terminal. 

Format: 

CP. 

CP,n 1 /ops 1 ,n 2 /ops2,...,n n /ops n . 

nj Control point number or job name. 

/opsj List options; a continuous string of up to 10 characters indicating the portion 

of the control point area, or control point related data, to be dumped. If list 
options are specified, they apply only to the control point number or job name 
(n) with which they are associated. Valid options are as follows: 

X Dumps exchange package, parameter summary, and contents of 

the memory locations indicated by the values in each exchange 
package register. These register values are treated as relative 
addresses within the field length; invalid addresses are 
represented with contents of zero. 
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T Provides detailed dump of control point area with English 

description of each parameter field and NOSTEXT symbol for 
each word. 

A Dumps job dayfile pointers and buffer in word format with 

display code character equivalents. This format is the same 
format as E Memory Dump directive. This option also dumps 
the buffer in a line-by-line format, as on the DSD A display. 

F Provides dump of FNT/FST, EST, and mass storage track chain, 

if one exists, for all files attached to the specified control point. 

C Dumps field length of specified control point in instruction 

parcel format with display code character equivalents. This 
format is the same format as C Memory Dump directive. 
Repetitive data is suppressed. 

D Dumps field length of specified control point in byte format 

with display code character equivalents. This format is the 
same format as D Memory Dump directive. Repetitive data is 
suppressed. 

E Dumps field length of specified control point in word format 

with display code character equivalents. This format is the 
same format as E Memory Dump directive. 

G Dumps control point area in instruction parcel format with 

display code character equivalents. This format is the same 
format as C Memory Dump directive. 

H Dumps control point area in byte format with display code 

character equivalents. This format is the same format as D 
Memory Dump directive. 

I Dumps control point area in word format with display code 

character equivalents. This format is the same format as E 
Memory Dump directive. 

P Provides dump and analysis of all active PPs associated with 

control point n. 

default If n is specified with no corresponding list options, options 
XTAF are selected automatically. Refer to Printer Output 
Listing Examples for a sample of the printer output listing 
produced. The default options selected can be changed with the 
CPO directive. 

All of the list options specified for a particular control point area (up to 10) 
are processed. For example, if the C and D options are both specified, the 
control point field length is dumped twice, once in instruction parcel (C) 
format and again in byte (D) format. 
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CPO — Reset Default List Options 

The- CP-O ■directive selects a new string of default list options for the CP directive. 
Format: 

CPO,ops. 

ops New default list options for CP directive, a continuous string of up to 10 

characters. Refer to description of CP directive for list of valid option 
characters. 



PP — Dump PP Communication Areas 

The PP directive causes the contents of all PP communication areas to be dumped in byte format with 
display code character equivalents. This format is the same format as that for the D Memory Dump 
directive. The control point assignment, channel assignment, and monitor function are listed with each 
communication area. Refer to Printer Output Listing Examples for a sample of the printer output listing 
produced by this directive. Refer to Interactive Use of DSDI for additional information concerning use 
of this directive from an interactive terminal. 

Format: 

PP. 



Dp — Dump Dayfile Buffer Pointers 

The DP directive causes the dayfile buffer pointers to be dumped in byte format with display code 
character equivalents. This format is the same format as that for the D Memory Dump directive. 

Format: 
DP. 



EST — Dump Equipment Status Table 

The EST directive causes the equipment status table to be dumped in byte format with display code 
character equivalents. This format is the same format as that for the D Memory Dump directive. 

Format: 
EST. 
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FNT — Dump File Name/File Status Table and FNT Interlock Table 

SL F W N I lf eC h tive f uses ? he , file ^me/file status table (FNT/FST) to be dumped in byte format with 
diW?J I t C f har f Ct D er talents. This format is the same format as that for the D Memory Dump 
set S thh Itr t0 / n " ter Output Listing Examples for an example of the FNT interlock table. Each St 

i>h of the t?hlV thi C f f? a \ in ^ rlocked file ' The ™T address of the interlocked file is listed to the 
right of the table, the leftmost address corresponding to the rightmost bit. 



Format: 
FNT. 



MST — Dump Mass Storage/Track Reservation Tables 

The MST directive causes all mass storage and track reservation tables to be dumped unless equipment 
numbers are s P ec,f,ed, in which case only the specified equipment MSTs are dumped! The ump om 
wo'rd ThTLtr g ftl abl f re 5 ects . K the appropriate parameter fields and NOSTEXT symb7of each 
*Ztv l P k ? Ump descnbin e tne track reservation tables is presented in byte format with 

are P ndi,«t^ f ^^f e ^ va ' e, l ts - The track link byte ordinal and status bits (three groups of four bits) 
n£^W^£~ ^ Print6r ° UtPUt ""** EXampleS f ° r 3 «"* te of^eVmter output' 

Format: 
MST. 
MST,xx l5 xx 2 ,...,xx n . 

xx i Equipment number of equipment whose mass storage table is to be dumped. 



JC — Dump Job Control Area for Each Origin Type 

The JC directive causes the job control area for each job origin type to be dumoed The dumn i* 
formatted to reflect the appropriate parameter fields and NOSTEXT symbol for each 3d P 

Format: 
JC. 

ACCOUNT — Dump Account Dayfile Buffer 

The ACCOUNT directive causes the account dayfile pointers and buffer to be dumped in word format 

hT P W M rdS Per ^ ne) W j th diSplay COde Character ^valents. This format is the same format as thafo 

DSD A^spla?. ' 1Ve * ThlS direCtiVG *° dUmpS the bUffeF in a ""byline format as on the 

Format: 

ACCOUNT. 
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ERRLOG — Dump Error Log Dayfile Buffer 

The ERRLOG directive causes the error log dayfile pointers and buffer to be dumped in word format 
(four words per line) with display code character equivalents. This format is the same format as that for 
the E Memory Dump directive. This directive also dumps the buffer in a line-by-line format, as on the 
DSD A display. 

Format: 

ERRLOG. 



DDB — Dump Dayfile Dump Buffer 

The DDB directive causes the dayfile dump buffer to be dumped in byte format with display code 
character equivalents. This format is the same format as that for the D Memory Dump directive. 

Format: 

DDB. 



EPB — Dump ECS/PP Buffer 

The EPB directive causes the ECS/PP buffer to be dumped in byte format with display code character 
equivalents. This format is the same format as that for the D Memory Dump directive. 

Format: 
EPB. 



DAYFILE — Dump System Dayfile Buffer 

The DAYFILE directive causes the system dayfile pointers and buffer to be dumped in word format (four 
words per line) with display code character equivalents. This format is the same format as that for the E 
Memory Dump directive. This directive also dumps the buffer in a line-by-line format, as on the DSD A 
display. 

Format: 

DAYFILE. 



MAINLOG — Dump Binary Maintenance Log Dayfile Buffer 

The MAINLOG directive dumps the binary maintenance log dayfile pointers and buffer in word format, 
four words per line, with display code character equivalents. 

Format: 

MAINLOG. 
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SECDED - Dump SECDED Identifier Table 

The SECDED directive causes the single error correction double error detection (SECDED) identifier table 
to be dumped in byte format with display code character equivalents. This format is the same format as 
that for the D Memory Dump directive. 

Format: 

SECDED. 



MTR - Dump CPU Monitor 

The MTR directive causes the CPU monitor to be dumped. Exchange packages are dumped in exchange 
package format while the program area is dumped, using relative addressing, in instruction parcel format 
with display code character equivalents. This format is the same format as that for the C Memory Dump 
directive. 

Format: 

MTR. 



RPL - Dump Resident Peripheral Library 

The RPL directive causes the resident PP library to be dumped in byte format with display code character 
equivalents. This format is the same format as that for the D Memory Dump directive. A header line for 
each PP program dumped indicates the name of the program and its length in bytes. Each succeeding line 
contains 10 bytes (two central memory words) of the PP program. The PP address of the first byte in 
each line, relative to address zero of the PP, is also listed. 

Format: 

RPL. 



RCL - Dump Resident Central Library 

The RCL directive causes the resident central library to be dumped in instruction parcel format with 
display code character equivalents. This format is the same format as that for the C Memory Dump 
directive. 

Format: 

RCL. 



PLD - Dump Peripheral Library Directory 

The PLD directive causes the PP library directory to be dumped in byte format with display code 
character equivalents. This format is the same as that for the D Memory Dump directive. 

Format: 

PLD. 
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CLD - Dump Central Library Directory 

The CLD directive causes the central library directory to be dumped in byte format with display code 
character equivalents. This format is the same format as that for the D Memory Dump directive. 

Format: 

CLD. 



PROBE ■ Dump PROBE Data Tables 

The PROBE directive causes the PROBE data tables to be dumped in byte format with display code 
character equivalents. 

Format: 

PROBE. 
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SUBSYSTEM DUMP/ AN ALYSIS DIRECTIVES 

The subsystem dump/analysis directives provide the capability to selectively dump portions of central 
and/or PP memory associated with a specific subsystem (BATCHIO, EI200, MAGNET, and TELEX). 
Although many other directives previously described in this section can be used to dump the same areas 
of memory, these directives dump those areas most frequently analyzed when subsystem related 
malfunctions occur. In addition, many of the dumps are specially formatted to provide a detailed 
description of the area being dumped. If the specified subsystem was not active at the time the EDD file 
was created, an error message is issued. 



BATCHIO — Dump Associated Memory for Analysis 

The BATCHIO directive causes areas of central and/or PP memory that are most frequently analyzed 
when BATCHIO malfunctions are indicated to be dumped. The areas and type of memory dumped is 
determined by the list options specified. 

Format: 

BATCHIO,ops. 

ops List options; a string of characters indicating the areas of memory to be 

dumped. If no options are specified, both options (PB) are selected by default 
and are processed in order as listed. 

P Provides analysis and full memory dump of PPs having resident 
copies of 1CD, 110, QAP, QAC, or DSP. The output listing 
generated is the same (in format and content) as that produced by 
entering the AP directive in the following format. 

AP,1CD,1I0,QAP,QAC, DSP. 

Refer to the description of the AP directive, PP Dump Directives, 
for additional information. 

B Provides specially formatted dumps of each active BATCHIO buffer 
point. Included with the dump of each buffer point is the associated 
equipment type and FET, as well as EST and FNT/FST entries. 



EI200 — Dump Associated Memory for Analysis 

The EI200 directive causes areas of central and/or PP memory that are most frequently analyzed when 
Export/Import malfunctions are indicated to be dumped. The areas and type of memory dumped is 
determined by the list options specified. The following three words are always listed at the beginning of 
the listing, in byte format, regardless of which list options are selected. 

• Driver recall word for 1ED (DRCL). 

• Executive call word for 1LS (EXCL). 

• Input register for 1LS (IREX). 



60455380 D 10-21 



Format: 

EI200,ops. 



°P S List options; a string of characters indicating the areas of memory to be 

dumped. If no options are specified, all four options (LTPO) are selected by 
default and are processed in order as shown. 

L Dumps EI200 low core pointer words. The dump is formatted to 
reflect the appropriate parameter fields and NOSTEXT symbol for 
each word. 

T Provides specially formatted dump of EI200 terminal tables with 
associated FET, EST, and FNT/FST. Each word of the terminal 
tables is formatted to reflect appropriate parameter fields. In 
addition, each word is preceded by a description of the parameter 
fields and its NOSTEXT symbol. 

P Provides analysis and full memory dump of all PPs containing copies 
of 1ED, 1LS, and XSP. The output listing generated is the same (in 
format and content) as that produced by entering the AP directive in 
the following format. 

AP,1ED,1LS,XSP. 

Refer to the description of the AP directive, PP Dump Directive, 
for additional information. 

O Dumps PP overlays that reside within the EI200 field length in byte 
format with display code character equivalents. A header line for 
each overlay dumped indicates its length in bytes. Each succeeding 
line contains 10 bytes (two central memory words) of the program. 
The PP address of the first byte, relative to address zero of the PP, 
is also listed. 



MAGNET — Dump Associated Memory for Analysis 

The MAGNET directive causes areas of central and/or PP memory that are most frequently analyzed 
when a ma function within MAGNET is indicated to be dumped. The areas and type of memory dumped 
are determined by the list options specified. y uumpea 

Format: 

MAGNET,ops. 

°P S List options; a string of characters indicating the areas of memory to be 

dumped. If no options are specified, all three options (UQP) are selected by 
default and are processed in order as listed. 

U Provides specially formatted dump of the MAGNET unit descriptor 
tables (UDTs) with associated FET, EST, and FNT/FST. Each word 
of a UDT is formatted to reflect appropriate parameter fields. In 
addition, each word is preceded by a description of the parameter 
fields and its NOSTEXT symbol. If extended labels are present, they 
appear with the FET in the output listing. The FET also indicates 
the address and control point number of the user. 
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Q Provides dump of the MAGNET queue table in byte format (two 
words per line) with display code character equivalents. The first 
word in each line is preceded by its ordinal within the table. 

P Provides analysis and full memory dump of all PPs having resident 
copies of 1MT. The output listing generated is the same (in format 
and content) as that produced by entering the AP directive in the 
following format. 

AP,1MT. 

Refer to the description of the AP directive, PP Dump Directives, 
for additional information. 



IAF/TELEX — Dump Associated Memory for Analysis 

The IAF and TELEX directives cause areas of central and/or PP memory that are most frequently 
analyzed when IAF or Time-Sharing Module malfunctions are indicated to be dumped. The areas and type 
of memory are determined by the list options specified. The IAF or Time-Sharing Module current entry 
word (SSPA) is always printed at the beginning of the listing, in byte format, regardless of which list 
options are specified. The appropriate directive must be used to produce the dump (IAF is used with the 
rnteractive Facility and TELEX is used with the Time-Sharing Module). DSDI produces the same listing 
for either command. 

Format: 

IAF,ops. 

or 
TELEX,ops. 

ops List options; a string of up to four characters indicating the areas of memory 

to be dumped. If no options are specified, all four options (CTEP) are 
selected by default and processed in order as listed. 

C Provides dump of the IAF or Time-Sharing Module command table. 

T Provides specially formatted dump of the IAF or Time-Sharing 
Module terminal table in which each word reflects the appropriate 
parameter fields. In addition, each word is preceded by a 
description of the parameter fields and its NOSTEXT symbol. 

E Dumps IAF or Time-Sharing Module reentry table in byte format 
(two words per line) with display code character equivalents. The 
first word in each line is preceded by its ordinal within the table. 
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P Provides analysis and full memory dump of all PP having resident 
copies of TLX, 1TA, 1TD, and 1TO. This option also provides an 
analysis and dump of all PPs having resident copies of 1RO and 1RI 
that are associated with control points of time-sharing origin. The 
output listing generated is the same (in format and content) as that 
produced by entering the AP directive in the following format. 

AP,TLX,1TA,1TD,1T0,1R0,1RI. 

The exception is that the AP directive also dumps all PPs having 
copies of 1RO and 1RI rather than only those associated with control 
points of time-sharing origin. Refer to the description of the AP 
directive, PP Dump Directives, for additional information. 

HARDWARE REGISTER DUMP DIRECTIVES 

The hardware register dump directives provide a capability to dump specified hardware registers. 

XP — Dump Deadstart Exchange Package 

The XP directive causes the CPU exchange package executing at the time of deadstart to be dumped. If 
there are two CPUs in the system, both exchange packages in execution at the time of deadstart are 
dumped. 

Format: 

XP. 

SC — Dump S/C Register 

The SC directive is valid only on a CYBER 170 series computer system and causes the S/C registers to be 
dumped. 

Format: 

SC. 

INTERACTIVE USE OF DSDI 

Incorporated within DSDI is an interactive facility which allows several of the directives described 
earlier in this section to be entered interactively from a time-sharing origin job. This interactive facility 
is designed to provide the analyst with the following additional capabilities. 

• Allows preliminary examination of the EDD file to determine which areas should be listed in 
detail at a line printer. 
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• Allows examination of certain areas of the EDD file not listed during normal operational 
procedures following a system malfunction. Typically, predefined portions of the EDD file are 
listed following a system malfunction. 

• Allows on-line examination of the EDD file from a remote location. 

Refer to Example of DSDI Terminal Usage for an example showing interactive use of DSDI. 

When the DSDI control statement is entered from an interactive terminal (batch subsystem or X 
command only), a delay will be experienced before input directives can be entered. During this time (10 
to 60 seconds), DSDI is copying the EDD file to a random mass storage file. The length of the delay is 
dependent upon device speed and current system activity. When DSDI is able to accept input directives, 
it will issue the following prompt to the terminal. 

ENTER DIRECTIVES- - 
? 

Directives are entered following the question mark prompt. Only one directive can be entered at a time, 
and is restricted to one line. The format is the same as described for batch input (refer to Directive 
Format). 

Generally, any of the DSDI input directives can be entered at an interactive terminal. However, the 
output produced by many of the directives is formatted for listing only at a line printer (136 columns) and 
cannot be listed at the terminal (72 columns). The L parameter on the DSDI control statement initially 
determines the disposition of the list output. If a file name is not specified, list output is assigned to file 
OUTPUT by default (that is, the terminal). In this case, entry of directives which produce output that 
cannot be listed at the terminal results in the message: 

DIRECTIVE RESTRICTED TO PRINTER OUTPUT. 

If a list output file name is specified on the DSDI control statement, all input directives can be entered 
at the terminal. All list output (including error messages) is written to the specified file. 

Two input directives are provided to further control the disposition of list output. 

OUTPUT,filenam. This directive is used to assign output to alternate file filenam (file name 
OUTPUT is illegal; that is, alternate list output cannot be assigned to the 
terminal). If filenam is omitted, the system assumes file name ALTRNT. 
While this directive is active, all input directives can be entered at the 
terminal. All list output (except error messages) is written to file filenam 
and is formatted for transmission to a line printer. Error messages are 
written directly to the terminal. 

DISPOSE. This directive disposes the alternate list file (specified in OUTPUT directive) 

to the print queue. Output will be printed at the central site line printer. All 
subsequent list output resumes on the original output file specified on the 
DSDI control statement. 

Refer to File Manipulation and Control Directives for additional information concerning use of these 
directives. 
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TERMINAL OUTPUT DIRECTIVES 

The following directives produce output formatted for listing at an interactive terminal. 

C — Dump Memory in Instruction Parcel Format 

The C directive causes the specified locations of central memory or ECS to be dumped in four groups of 
five octal digits (one word per line) with display code character equivalents. No pagination is processed 
for terminal output. The CM and EC directives (CM/ECS Dump Directives) determine The type of 
memory to be dumped; default is central memory. The RA or RAC directive (CM/ECS Dump Directives) 
must be entered to dump relative addresses; default is absolute addressing. 

Format: 

C,fwa,lwa. 

fwa First-word address to be dumped (mandatory). 

lwa Last-word address, plus one location, to be dumped. If omitted, fwa+1 is 

assumed by default. 

Example of terminal output: 

? C, 6230, 5243. 

H306230 34240 13103 00012 50036 1T*A AU 3 

'3006231 00764 70000 01.4030 10113 * AAK 

(10P5232 04154 70000 00000 10113 DM * AA V 

'1036233 00004 6744 6 7*030 10H«5 a E 

0006234 Q5153 0570W 30030 30^00 FM* 

0006235 00000 00000 00000 00300 

0006236 30 02 00000 00000 00000 

0006237 00000 03005 05111 14422 EEII9R 

D — Dump Memory in Byte Format 

Th f . D . di ff c * ive caus f reified locations of central memory or ECS to be dumped in five groups of four 
octal digits (one word per line) with display code character equivalents. No pagination is processed for 
terminal output. The CM and EC directives (CM/ECS Dump Directives) determine the type of memory 
to be dumped; default is central memory. The RA or RAC directive (CM/ECS Dump Directives) must be 
entered to dump relative addresses; default is absolute addressing. 

Format: 

D,fwa,lwa. 

fwa First-word address to be dumped (mandatory). 

lwa Last-word address, plus one location, to be dumped. If omitted, fwa+1 is 

assumed by default. 
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Example of terminal output: 

? 0,6230,6240. 



00^6230 


34 24 


0101 


000 


3125 


0036 


1TAA AU 3 


0006231 


76 


4700 


00 00 


0001 


0113 


* AAX 


0005232 


0415 


4 70 


3000 


0001 


0113 


DM* AAK 


0006233 


0000 


4674 


4674 


00 01 


0005 


- - A E 


0006234 


0515 


3057 


0000 


0000 


0000 


EMX. 


00062 3 5 


00 00 


0000 


000 


13000 


0000 




0006235 


0000 


000 


0000 


0000 







000 6 23 7 


0000 


0980 


505 


1111 


4422 


EEII9R 



Q — Dump PP Memory in Line Format 

The Q directive causes the specified locations of PP memory to be dumped in line format. Each line 
contains 10 octal bytes (PP words) with display code character equivalents. Repetitive lines are 
suppressed and zero bytes are represented by hyphens. 

Format: 

Q,n,fwa,lwa. 

n Number of PP to be dumped. 

fwa First-word address to be dumped. 

lwa Last-word address, plus one location, to be dumped. 



NOTE 



fwa and lwa are automatically adjusted so that 
the dump limits fall within a multiple of 10 octal 
words. 



This format is valid only for terminal output. If attempted from a batch origin job or while an alternate 
list file is active, the fwa and lwa parameters will be interpreted as PP numbers. 

Example of terminal output: 

•? n t; 'j. I r, •?. 



000 


0003 


2020 


3340 





614 





4334 


0117 


CP?05 FL 91 AG 


010 


0064 


0001 


7772 


010 


00 6 


1073 


1&<AI 


6072 


A 7 \ FH LA 


020 


2250 


3225 





00 2 7 


0012 


4402 


57*7 


5751 


P/ZU tf J93.*. ( 


30 


2 011 


7646 





0001 


0141 


0600 








I - AA5F 


040 


1501 


1116 


2014 


0074 


203 











MAINPL HC 


050 


3404 


2330 


?I335 


6213 


1707 





4 00 


6575 


1DSX 2 KOG 5 


050 





4521 





6101 


0001 


0153 


0001 


0532 


+Q A AA$ A?Z 


070 


0001 


0100 


1000 


000 3 


5000 


6250 


6251 


6252 


AA H C / ( ) 
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PP — Dump PP Communication Areas 

The PP directive causes the PP number, executing program name, control point assignment, and input 
register address for each PP communication area to be dumped. 

Format: 

PP. 

Example of terminal output: 

? pp PP Number 

J Control Point Assignment 

PP00 PP01 PP02 PP03 PP04 1 PP05 PP06 PP07 PP10 ppn 
MTR-01 DSD-30 1MT-25 1TD-01 ALS-27 1SP-30 1ED-27 1LS-27 1TA-01 CIO-05 
6200 6210 6220 6230 /6240 6250 6260 6270 6300 6310 

/ Input Register Address 
Program in Execution 



CP — Dump Active Control Point Areas 

The CP directive is used to dump the job name and control point area address for each control point. 



Format: 
















CP. 
















Example of terminal output: 


















Control Point 
Area Address 


Control Point Number 
\ Job Name at Control Point 




? CP. 








\ 








CP 01 
TELEX 
0200 


CP 02 

RAN0AAX 

0400 


CP 03 
0600 


CP 04\ 

1000 


CP 05 ' 
, AJNQBSI 
U200 


CP 06 
1400 


CP 07 
1600 


CP 10 
2000 


CP 11 
2200 


CP 12 
2400 


CP 13 
2600 


CP 14 

AJ0IBTI 

3000 


CP 15 
3200 


CP 16 
3400 


CP 17 
3600 


CP 20 
4000 


CP 21 
4200 


CP 22 
4400 


CP 23 
4600 


CP 24 
5000 


CP 25 

MAGNET 

5200 


CP 26 
5400 


CP 27 

EXPORTL 

5600 


CP 30 

SYSTEM 

6000 
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EXAMPLE OF DSDI TERMINAL USAGE 

This example illustrates how DSDI might be used, following a system malfunction, to analyze portions of 
the EDD file from an interactive terminal. It is assumed that an EDD file was created during normal 
system recovery procedures. Vertical spacing has been expanded to permit commentary. The example 
begins after the login sequence has been completed. 



batch 

$RFL,0. 

/labei,dump,vsn=dump,lb=ku,f=s,mt,d=800 



Enter batch subsystem. 

The LABEL control statement is entered to 
assign the EDD dump tape to this job. 
Use of the VSN parameter allows the job 
to be rolled out while the tape is mounted 
and ASSIGNed. 



/get,altdir 

/dsdi. 

ENTER DIRECTIVES — 



Retrieve alternate directives file 
ALTDIR (refer to example in figure 10-2). 

Calls DSDI which copies EDD tape to a 
random mass storage file. 



iLiiier terminal output directives vreier 
to Terminal Output Directives) to list 
any portion of the EDD file at the terminal. 
DSDI issued the prompt (?) when it is 
ready to accept a new directive. 



?output,altout. 



List output produced by subsequent direc- 
tives is written to local file ALTOUT. 
This allows entry of directives which 
produce line printer formatted 
output. 



?read,altdir. 



?dispose. 



All input directives in alternate direc- 
tives file ALTDIR are read and processed. 
List output is written to local file 
ALTOUT. DSDI does not request terminal 
input until last directive on ALTDIR is 
processed. 

Dispose local file ALTOUT to the print 
queue for listing at the central site line 
printer. Output produced by subsequent 
directives is listed at the terminal. 



EXPRESS DUMP COMPLTE (FL USED xxxxxxB) 

/ 



DSDI is terminated by pressing carriage 
return in response to the ? prompt. 
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In summary, the following operations were performed by DSDI. First, small areas of the dump file were 
listed at the terminal for preliminary examination. This was done both to analyze the cause and effect 
of the system failure, as well as determine the extent of line printer listings required. An appropriate 
comment may be placed in the list file subtitle at this time via the *.ccc...ccc directive. 

Next, directives were entered to generate the necessary line printer listings. These listings are generaUy 
extensive, or contain specially formatted output that cannot be listed at the terminal. Thus, output was 
written to an alternate list file named ALTOUT. 

After all necessary directives had been entered from the terminal, an alternate directives file (ALTDIR) 
was read. ALTDIR is a permanent file containing input directives necessary to obtain a printer listing of 
specific areas in the dump file that are frequently examined foli ow ing a system failure (for example, 
CMR tables and buffers, PP memory, and so on). Figure 10-2 illustrates a typical alternate directives 
file. Comments describing areas of the dump file to be listed appear, with the directive, in the title line 
of the output listing. 

When DSDI finished processing the last directive in file ALTDIR, it again issued the ? prompt to the 
terminal requesting further directive input from the keyboard. At this time, the DISPOSE directive was 
entered causing file ALTOUT to be printed at the central site line printer. Refer to Printer Output 
Listing Examples for examples of printer output listings. 



DUMPt 

LC. 

PP. 

CPO,H. 

EJOFF. 

EJ. 

CP. 

CPO,XTAF. 

DP. 

EJ. 

EST. 

FNT. 

EJ. 

MST. 

JC. 

CP,SYSTEM/A. 

ACCOUNT. 

ERRLOG. 

EJON. 

AP. 



LOW CENTRAL MEMORY POINTERS 
PP COMMUNICATION AREA 



CONTROL POINT AREAS 

DAYFILE BUFFER POINTERS 

EQUIPMENT STATUS TABLE 

FILE NAME TABLE AND FNT INTERLOCK TABLE 

MASS STORAGE TABLES 
JOB CONTROL PARAMETERS 
SYSTEM DAYFILE BUFFER 
ACCOUNT FILE BUFFER 
ERROR LOG BUFFER 

ACTIVE PPUS 



Figure 10-2. Typical Alternate Directives File 



t All records in an alternate directives file must be in text format; the first word in each record 
contains only the record name. 
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PRINTER OUTPUT LISTING EXAMPLES 

The listings illustrated in. this section are samples of the line printer output listings produced by several 
of the input directives described in the Input Directives section. 

Each page of output listings begins with two header lines: a title line and a subtitle line. The title lines 
are formatted as follows: 

RA = current input directive EXPRESS nn DSDI - V2.0 yy/mm/dd. hh.mm.ss. PAGE n 

0000000 dump type hh.nm.ss. yy/mm/dd. CDC MULTI-MODE OPERATING SYSTEM NOS 1 comments 

RA=0000000 

Indicates absolute addressing is in effect. If relative addresses were being dumped (RA or RAC 
directive entered), a nonzero reference address would appear in this field. 

current input directive 

Input directive currently being processed, including comments (50-character field). 

EXPRESS nn 

Reflects the EDD tape number currently being used (nn is a two-digit dump identifier assigned 
during EDD). 

yy/mm/dd. hh.mm.ss. 

This field reflects the date and time when DSDI was executed. 

dump type 

Indicates type of memory currently being dumped (CM, ECS, or a PP number). If the AP 
directive is processed, the PP number is followed by the name of the program currently being 
dumped. 

hh.mm.ss. yy/mm/dd. CDC MULTI-MODE OPERATING SYSTEM NOS 1 

Time of day, date, system title line, and system version name taken from low core locations 
TIML and DTEL (80-character field). 

comments 

Up to 36 characters of comments specified on a *.ccc...ccc input directive 
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Example 1: 



J— :S3? U1UStrateS the PrintCT ° UtpUt "^ <*°«™* * «» PP active (dun* PP 



RA = 
0000001] 



PPU COMMUNICATION AREAS. „„„,-„ „, 

0S.3*.2 5 . 77/09/1*. CDC MULTI-MODE 0«»£R«TING SrSTEM. 



0301 - 1/2.0 
NOS 1 



77/09/16. 16.5*. 53. PAGE 1 

1AJ HUNG USING EHC HA3HINE 



MTR 152* 221B flrjOG 0300 0000 

oooo oooa ooio oooo oooo 

CP10 oooo oooo oooo oooo oooo 

oooo OOOO oooo oooo oooo 

oooo oooo oooo oooo oooo 

OOOO 0000 0000 OOOO 0003 

oooo oooo oooo oooo oooo 
oooo oooo oooo oooo oooo 

LFM 1*06 1552 001* 0000 0120 

SPLH 3061 *37* 0056 1 *0 3 7000 

CP12 1*06 1552 001* OOOO 0120 

OOOO OOOO OOOO 5005 00.55 

6000 OOOO OOOO 0020 0010 

0*C0 0153 OOOl 5500 0153 

5555 5555 5535 57*3 *23* 

5555 5555 5533 5733 *0*<, 

ISP 3*23 2013 0030 OOOO OOOO 

EATM 0032 0002 7700 0001 OOOO 

CP13 3*23 2013 OOOO OOOO OOOO 

OOOO OOOO OOOO 5003 00*7 

6000 OOOO OOOO 0020 0010 

OOOO OOOO OOOO oooo oooo 

5555 5555 5533 57<t2 36*1 

5555 5555 5533 5733 *33g 

110 3*11 1751 oioo 0001 OOOO 

DEQM 0005 0022 OOOO OOOO OOOO 

CPU 3*11 1751 oioo 0001 OOOO 

OOOO OOOO OOOO 5003 00*7 

6000 OOOO OOOO 0020 0010 

OOOO OOOO oooo oooo oooo 

5555 5555 5533 57** 36*3 
5555 5555 5533 5733 *1*0 

OOOO OOOO OOOO OOOO 3130 

OOOO OOOO OOOO OOOO OOOO 

CPOO 0717 2*17 5535 5755 OOOO 

OOOO OOOO OOOO 0027 2500 

OOOO OOOO 0051 0027 2(,03 

OOOO OOOO OOOO OOOO OOOO 

5555 5555 3**0 5740 *337 

5555 5555 5533 5733 3**0 

OOOO OOOO OOOO OOOO 31*0 

0040 OOOO OOOO OOOO OOOO 

CPOO 3*15 2*10 3012 OOOO 0001 

0010 0076 0022 OOOO OOOO 

6000 OOOO OOOO 0020 0010 

OOOO OOOO oooo oooo oooo 
5555 5555 553* 57*3 36*2 
5555 5555 5533 5733 35*0 



Program in Execution 
Control Point Assignment- 
Channel Assignment 




LFM) L JP 

s Uc 

LFM) L AP 



A? A 1 ? A* 
0.371 
0.059 



1SPK 

Z 9 

1S»K 



736 
053 



1I0(A 

E R 
1I3(A 



0.93>? 
0.065 



GOTO, 2. 



WU 

WTC 



15.53* 
0.015 



1MTHXJ 

H R 



1.837 

0.025 



0*23 0*13 OOOO OOOO OOOO 

OOOO OOOO OOOO OOOO OOOO 

3*0* 1*13 0010 00** 0135 

OOOO OOOO OOOO OOOO OOOO 

0005 0056 0055 0023 0005 

0003 0017 0016 000* 0001 

0022 0031 0055 0025 0023 

0005 0022 OO55 0003 0001 

" P0 * OOOO OOOO OOOa OOOO 32?0 

OOOO OOOO 0000 OOOO oooo 

CPOO 3*15 2*10 1313 OOOO 0001 

oooa oooo oooo 52*0 01** 

6000 OOOO OOOO 0020 0010 
OOOO OOOO oooo oooo oooo 

5555 5555 5533 5733 3**3 
5555 5555 5533 5733 3335 

PP05 OOOO 0000 OOOO OOOO 3030 

OOOO OOOO OOOO oooo oooo 

CPOO 0301 1*14 5101 5255 OOOO 

OOOO OOOO OOOO 000* 0*00 

OOOO OOOO 0061 000* 0303 

0030 3030 OGuu OuuQ 0808 

OOOO OOOO OOOO OOOO OOOO 

5555 5555 5533 5733 3335 

3*15 2*10 1313 OOOO 0001 

0012 0013 OOOO 1066 1365 

3*15 2*10 1313 OOOO 0001 

OOOO OOOO OOOO 5003 00*7 

,, .. „ 6000 OOOO OOOO 0020 0010 

-Monitor Function OOOO OOOO OOOO OOOO OOOO 

5555 5555 5533 57** *0*3 

5555 5555 5533 5733 *1*3 




PP11 



PP21 



OOOO OOOO OOOO OOOO 3050 

OOOO oooo oooo oooo oooo 

CPOO 3*15 2*10 1313 OOOO 0001 

0016 0076 0022 OOOO 0153 

6000 OOOO OOOO 0020 0010 

OOOO OOOO OOOO OOOO oooo 

OOOO OOOO oooo oooo oooo 

5555 5555 5533 5733 33*0 

OOOO OOOO OOOO 0000 3120 

OOOO OOOO OOOO oooo oooo 

CPOO 3*15 2*10 3012 OOOO 0001 

OOOO OOOO OOOO 5003 00*7 

6000 OOOO OOOO 0020 0010 

OOOO OOOO oooo oooo oooo 

5555 5555 5533 5737 *237 
5555 5555 5533 5733 3637 



1DLK H 9A2 

E , S E 

C N A 

? r us 

E R C A 

ZP 

IMTHKK A 
15A9 



0.018 
0.002 



DO 
DCC 



IMTHKK 

J K 
IMTHKK 


A 
H K 
A 

ft » 
P H 


0. 
0, 


.958 
.068 




X/ 


IMTHKK 
N R 


A 

AS 

P H 



0.005 



1.1THXJ A 

/C • 



0.*7* 
0.03* 
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Example 2: 

The following sample illustrates the printer output listing produced by the AP directive (dump analysis of 
PP and PP memory in line format). 



RA = AP.IAJ. OUMP 1AJ. EXPRESS 02 

0000000 PP25 1AJ 03.34.25. 77/09/ 14. CDC MULTI-M0OE OPERATING SYSTE1. 



DSOI - »2.0 
NOS 1 



77/09/16. 16.54.33. PAGE 3 

1AJ HUNG USING EHC MACHINE 



ANALYSIS OF PP25 



3401 1201 0000 0000 0000 

0006 0000 000% 0000 0000 

0355 307* 2100 0102 6370 

7301 1070 3411 1415 0200 

0346 1444 0200 0346 0100 

0101. 0415 200<> 0000 0000 

0000 0000 0000 0000 0000 

0000 0000 0711 1610 4225 



0AH 1ILM9 
C-L99 C-A 
ADDM°D 



LAST MAIN PROGRAM LOADED - 1AJ 

LAST OVERLAY LOAOEO 

LAST MASS STORAGE DRIVER - 6L6 



RESIDENT ENTRY POINTS 
NAME L0C CALLER 



LOW CORE CONSTANTS 
NAME LOC ACTUAL EJECTED 





FTN 1 


0342 


6010 




RA 55 


; i 


9403 0403 




PRL 1 


0404 


3455 




FL 56 


i i 


9016 0016 




RCH 1 


0417 


0356 




ON 70 




9001 0001 




DCH 1 


0426 


0371 




HN 71 


i 


9100 0100 




DF1 1 


0462 


3014 




TH 72 




1000 1000 




EXR 1 


0516 


32 77 




TR 73 


; i 


3003 0003 




SMS 1 


0546 


6010 




CP 74 


i 


9200 0200 




P05 1 


0602 


0153 




IA 75 




3170 3170 




NOS 1 


9607 


0324 




0A 76 




3171 3171 




ROS 1 


9613 


0324 




MA 77 




3172 3172 




PPU MEHORY 














0000 
0020 
0040 


0003 
0030 


20 20 
1010 


3540 








5002 


0151 


CP°?5 /3A« 

XHH 

A A ABH 








0060 


0171 


0171 


0001 


0227 





0060 
0100 




















2000 


0177 


1781 


0576 


3075 


5050 


3051 


1237 


» A OAE X /X(J4 


01?0 


0200 


0155 


0200 


0405 


0115 


0005 


30 77 


6050 


9 A 3 3FAM EX / 


0140 


0331 


3D13 


0502 


3015 


3415 


5400 


3153 


3011 


3YXKE3XMlM= AUXI 


0160 


3413 


10 53 


443 


5400 


0266 


3412 


1461 


0200 


1KH OS= 3 1JL B 


0200 


1702 


3417 


1422 


0200 


346 


3076 


6003 


0200 


3B10LRB 1-X CB 


0220 


0344 


2030 


0477 


3517 


3037 


1906 


0607 


1071 


C9P 3 20XGHFFGH 


0240 


oaoi 


3433 


3017 


0200 


0616 


0746 


4017 


3407 


A1COB FNG-501G 


0260 


0740 


3S04 


0200 


04 30 


0100 


0154 


0036 


0102 


G5X03 OXA A= 3AB 


0300 
0320 




34 01 
30 33 


1452 


6173 


7762 
1006 








IAL> 
AX9 HFFHP O 


9001 


0610 


2000 


1770 


0340 


»576 


30 76 


5010 


3010 


0557 


0100 


0456 


3413 


E X 4XHE.A D.lH 


0360 


3010 


3111 


057? 


2001 


5523 


6370 


0320 


2001 


XHYIE PA S C°PA 


0400 


5010 


3014 


3456 


3013 


3455 


0100 


0470 


1457 


HXL1.XK1 AOL. 


0420 


0100 


1253 


3411 


141? 


0200 


0346 


0371 


3130 


A JUILJ3 C-C A 


0440 


6373 


0001 


6312 


0573 


6173 


1073 


oieo 


1100 


A JE H A I 


0460 


4001 


0520 


3014 


0403 


6313 


3045 


0290 


040i 


5AEPXLDC KX*B OF 


0500 


0451 


3076 


3402 


1410 


3400 


4301 


4400 


0432 


■HX 13LH1 5A9 D3 


0520 


17J3 


0403 


!0l4 


0557 


0100 


0450 


1302 


0200 


0CDCXUE.A D/K9B 


0540 


340 4 


0100 


1212 


2000 


3274 


3105 


6010 


3013 


lOA JJP Z YE HXK 


0560 


141,1 


3412 


1461 


0200 


0346 


3011 


1014 


3112 


L61JL 9 C-XIHLYJ 


0600 


0411 


0153 


0153 


0100 


10?6 


0100 


02 35 


3324 


OIASA^A HVA B2CT 


0620 


0627 


0700 


0711 


1404 


0200 


1010 


7100 


4027 


FWB GIL09 HH 5H 


0640 


0647 


0200 


0711 


1405 


0200 


1010 


7300 


6273 


F»3 GILES HH 


0660 


0503 


0102 


0615 


0100 


0773 


5100 


0573 


0100 


ECA3 C MA G / E A 


0700 


2042 


01)11 


aioo 


0301 


3004 


0200 


0421 


0315 


°7DTA CAX08 DQCM 



0010 0006 0004 1431 2405 40 30 F O LYTE5X 

0030 

0050 3401 1201 0403 0016 1AJA DC <i 

0070 0001 0100 1000 0003 0200 3170 3171 3172 AA H CB Y Y Y 

0110 1007 3474 3051 1377 1006 3350 0461 1006 HG1 X(K HFO/O HF 

0130 1701 6010 1701 6250 3050 1071 5400 0266 OA HOA /X/H = 3 

0150 1014 3112 6114 1073 0100 0531 5400 0267 HLYJ LH A EY= 9 

0170 0346 3011 1013 645 3012 0502 3015 3415 C-XIHKF*XJE8XMIH 

0210 054? 5600 0576 0320 2033 2305 3413 1063 E7, E CPP0SEKH 

0230 3406 1400 3407 0200 0606 4017 3416 5017 1FL 1G3 FF501M/0 

0250 3016 4417 3617 4017 1071 1021 3303 4417 XN903050H HQ0;?0 

0270 — «- 

0310 ,- 

0330 1701 0575 3010 1277 0313 5000 0101 1701 OAE XHJ CK/ AAOA 

0350 3076 6210 3010 1736 0760 2001 5531 6010 X HXH93G PA Y H 

0370 5523 2610 6010 3014 0440 0371 3074 1620 SVH HXLD5C X NP 

0410 6010 3074 3210 0562 1411 0200 0346 0356 HX ZHE LIB C-C, 

0430 1367 3411 1404 0200 0346 0371 2001 1360 K HLDB C-C P»< 

0450 2000 3411 1406 0200 0346 3011 0556 P 1ILF9 C-XIE, 

0470 1400 0100 2071 3401 5400 0465 1063 5400 LAP IA= H = 

0510 3601 3600 1115 0571 3602 6210 3277 3412 3A3 IME 38 HZ 1J 

0530 0155 5000 3526 5415 0006 0115 0007 3011 A / EV=N FAN 3X1 

0550 7200 3777 3413 5300 0600 5400 0576 0424 R 4 lKt F = E OT 

0570 6114 0573 0350 1100 0001 0001 LE C/ I A A 

0610 0033 0100 4325 0324 0150 0100 0245 5400 CA 8UCTA/A B*= 

0530 0425 1463 0323 1401 5400 0610 0346 5400 DUL CSLA= FHC-= 

0550 0560 1504 6600 0652 7540 3402 0200 0670 E HO F) 51B9 F 

0670 0660 1412 0200 1010 1401 7100 0573 0465 F LJ8 HHLA E 

0710 0100 0623 1400 5400 0575 5700 0610 0405 A FSL = E . FHDE 
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Example 3: 

The following sample illustrates the printer output listing produced by the CP directive (dump active 
e&n .tTol point areas). The default list options (XTAF) are used to dump the SYSTEM control point area. 
This example continues for two pages. Also, observe that the columns cross page boundaries; that is, the 
left column is read continuously, from the top of the first page to the bottom of the second page. The 
sequence then continues at the top of the right column on the first page. 



RA = CP,2. 
0000000 CM 



EXPRESS 00 
20.25.52. 80/01/12. C6) CYBER 174 S/N 620 DEVEL. 



DSDI - V2.0 

NOS 1-1B S 



80/01/31. 
*/R4B. 



08.35.16. 



CONTROL POINT 02 



CP0 2 EXCHANGE PACKAGE 



352 A0 60000 B0 



RA 


142100 


Al 


1 


Bl 


1 


FL 


60000 


A2 


546 


B2 


407 


EM 


70070000 


A3 


545 


B3 


771 


RAE 





Ait 


407 


B4 


767 


FLE 





A5 


551 


B5 


1066 


MA 


400 


A6 


1 


B6 


1337 







A7 


544 


B7 


1321 



CA0)=0000 0000 0000 0000 0000 

(Al)=0516 0420 0000 0000 0000 ENDP 

(A2)=0000 0000 0000 0000 0771 

(A3)=0000 0000 0000 0000 0765 

(A4)=0400 0005 6400 0000 0000 D E 

CA5)=6110 0000 0161 6000 1333 H A 

(A6)=05l6 0420 0000 0000 0000 ENDP 



(B0)=0000 0000 0000 0000 0000 

CB1)=0516 0420 0000 0000 0000 ENDP 
G (B2)=0400 0005 6400 0000 0000 D E 
G (B3)=0000 0000 0000 0000 0000 

CB4)=2705 5510 0126 0555 2205 WE HAVE RE 
K0 (B5)=0000 0000 0000 0000 0000 

(B6)=5555 5555 5555 5555 5555 



0000 0000 0000 0000 0000 

0000 0000 0000 0000 0000 

0000 0000 0000 0000 0544 

7777 7777 7777 7777 7773 

7777 7777 7777 7777 7676 

7777 7777 7777 7777 7776 

0516 0420 0000 0000 0000 ENDP 

0000 0000 0000 0000 0000 



(A7)=1725 2420 2524 0000 0025 OUTPUT U (B7)=0000 0000 0000 0000 0000 

(X0)=0000 0000 0000 0000 0000 

CXO = 0000 0000 0000 0000 0000 

E9 (X2)=1725 2420 2524 0000 0025 OUTPUT U 

CX3)=0000 0000 0000 0000 0000 

(X4)=0000 0000 0000 0000 0000 

CX5)=0000 0000 0000 0000 0000 

(X6)=0000 0000 0000 0000 0000 

(X7)=0000 0000 0000 0000 0000 



PARAMETER SUMMARY 



JOB NAME 
USER NUMBER 
PRIMARY FILE 
ORIGIN TYPE 
TIME USED 
TIME REMAINING 
QUEUE PRIORITY 

MESSAGE 1 
MESSAGE 2 



SYOT 
0000000004 
1014223345 

7760 



CPU STATUS 

SENSE SWITCHES 

KCL Rl 

KCL R2 

KCL R3 

KCL EF 

CPU PRIORITY 



00 
000000 
000000 
000000 

12 
030 



- PFM ILLEGAL REQUEST, AT 000524. 

- REQUEST DISPLAY. CDIS) A 



CURRENT CONTROL STATEMENT - ~ PACK1B COMPOSITE PL ATTACHED. 



LAST DAYFILE MESSAGE 



SPECIAL ENTRY POINTS 



20.07.19. PFM ILLEGAL REQUEST, AT 000524. 



Beginning of T List Option 



X List 
Option 



CONTROL POINT AREA 

CPU STATUS/AUTO RECALL STSW 000420 

CPU SUB-CP ACTIVE 

NUMBER PPS ASSIGNED 

ERROR FLAGS 

ACTIVITY COUNT 

RA/100 

FL/100 

JOB NAME 

JOB ORIGIN CODE 

OPER ASSiGNED EQUIP 

CPU PRIORITY 

QUEUE PRIORITY 



LQF 



JOB SEQUENCE NUMBER 



RFCW 000474 01012006 



JNMW 000421 04112333012006 



OAEW 

JCIW 000422 0030 



7760 



I CONTROL STATEMENT ADDRESS 
. DEM FILE RANDOM INDEX 
I RESERVED 

MAX MAGNETIC TAPES 
I MAX REMOVABLE PACKS 

MAX DEFER BATCH JOBS 
I MAX LOCAL WORK FILES 
1 MAX TIME LIMIT 
I MAX SRU LIMIT 
J MAX FIELD LENGTH 
I MAX ECS FIELD LENGTH 



ALMW 000475 7777 



Page Boundary 



RA = CP,2. 
0000000 CM 



EXPRESS 00 
20.25.52. 80/01/12. C6) CYBER 174 S/N 620 DEVEL. 



DSDI - V2.0 80/01/31. 08.35.17. 
NOS 1-1B SS /R4B. 



CPU STATUS FOR ROLLOUT 

ROLLOUT REQUESTED 

CPUS ALLOWABLE 

CM RESID TIME LIMIT 

QUEUE CONTROL 00 

CPU TIME SLICE LIMIT 000001000O 

TIME ENTERED X STATUS CPCW 000^24 OflOOOOOOOOOOOOOOOOOO 



TSCW 000423 00000721 



JOB CONTROL FLAGS 
REMOV. PACK INTERLOCK 
RESERVED 



ECSW 000425 0000 
CPIW t 



J MAX LINES PRINTED 77 

1 MAX CARDS PUNCHED 77 

j RESERVED ACLW 000476 7777 

I DAYFILE MESSAGES COUNT 7777 

. CONTROL STATEMENTS CNT 7777 

GQ A I DISPOSED OUTPUT COUNT 7 7 

MS PRUS COUNT 777777 

I ACCOUNT ACCESS WORD AACW 000477 77777777777777777777 

LENGTH BUFFER ICAW 000500 0000 
j ADDRESS BUFFER 000000 

LENGTH BUFFER 1 00 

I ADDRESS BUFFER 1 060000 
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ECS RA/1000B 




ECS FL/IOOOB 




PP INPUT REGISTER 


RLPW 000426 


PUNCH MODE/OVERRIDE 


SNSW 000427 



RESERVED- INSTALLATION 
PP PAUSE FLAGS 
SENSE SWITCHES 

MESSAGE 1 AREA 



MESSAGE 2 AREA 



INSTALLATION WORD 

INSTALLATION WORD 1 

INSTALLATION WORD 2 

INSTALLATION WORD 3 

INSTALLATION WORD it 

INSTALLATION WORD 5 

INSTALLATION WORD 6 

INSTALLATION WORD 7 

LIMIT FLAGS 

OVERFLOW FLAGS 

SRU ACCUMULATOR 

CP ACCUM (NANOUNITS/4 

10 ACCUMULATORS 

M13 = Ml * M3 

Mm = Ml " M4 

ADDER ACCUMULATOR 

Ml « 1000 

M12 = Ml - M2 

RESERVED 

CPM 

IOM 

SRU ACCOUNT BLOCK LMT 

COMPUTED SRU JOB STEP 

RESERVED 

SRU JOB STEP LIMIT 

SRU ACCUMULATOR 

RESERVED 

JOB STEP TIME LIMIT 



INOW 
IN1W 
IN2W 
IN3W 
IN4W 
IN5W 
IN6W 
IN7W 
SRUW 



) CPTW 
IOAW 
MP1W 

ADAW 
MP2W 



STLW 

LIMIT 

SRJW 



000430 
000431 
000432 
000433 
000434 
000435 
000436 
000437 
000440 
000441 
000442 
000443 
000444 
000445 
000446 
000447 
000450 



000451 
000452 
000453 



000454 

000455 
000456 
000457 



CPJW 000460 



0000 

0000 
00000000000000000000 

0000000 

0000 

0001 
00 
00 
55200615551114140507 
01145522052125052324 
56555501245533333340 
35375755000000000000 
02140557000055040000 
22052125052324550411 
23201401315755555104 
11235200000001005750 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 
00000000000000000000 

oooooooooooooooooooo 

00000000000000000000 

oooooooooooooooooooo 

0000 

00 

00000334605173 
00000000206473746400 
00226440000000000242 
000036 

000036 

000000 
023420 

001750 

00000000 
0000026260 

0000004610 
777777 

04610636646000 
0000 

777777 

0000000124 
0000 

777777 



PFM ILLEG 
AL REQUEST 
, AT 0005 
24. 

BLE. D 
REQUEST DI 
SPLAY. (D 
IS) A ./ 



CI ( 



R 5 B7 
3 3 



I SP ENTRY POINT FLAGS 

RESERVED 
I DMP= PARAMETER VALUE 
1 SSJr PARAMETER ADDRESS 

ENTRY POINT NAME 

SYSTEM PROCESSOR FLAGS 

PARAMETER 

PARAMETER LIST ADDRESS 

CCL - EFG 

CCL - RIG 

CCL - DATA 

RESERVED 

CCL - EF 

CCL - R3 

CCL - R2 

CCL - Rl 

SECURE MEMORY FLAG 

ECS AND CM CMM MODE FLAGS 

INPUT BUFFER ADDRESS 

RIGHT SCREEN BFR ADD 

LEFT SCREEN BFR ADD 

MAP OPTIONS LB1W 

RESERVED 

INTERACTIVE DEBUG CONTROL 

GLOBAL LIB INDICATORS 

SECOND LIB/GLOBAL I ND 

FIRST LIB/GLOBAL IND 

RESERVED 

ECS FL FOR DMP= CALL 

FL FOR DMPz CALL 

DUMP WORD COUNT 

FWA OF DUMP 

SSOW 

OUTSTANDING CONNECT COUNT 

COMPUTED CP TIME LIMIT CPLW 



SEPW 000501 0000 



SPCW 000502 000000 



JCDW 000503 00 



JCRW 000504 12 



DBAW 000505 



000000 

000506 00 

000000 

0000 

00000000 

000507 oooooooooooooooooooo 

000510 oooooooooooooooooooo 

000511 6701 

0000 

0600 
00 

000000 

000512 0000000000000000 

0000 

000513 37777777777777000000 

000514 oooooooooooooooooooo 

000515 oooooooooooooooooooo 

000516 oooooooooooooooooooo 

000517 oooooooooooooooooooo 

000520 oooooooooooooooooooo 

000521 oooooooooooooooooooo 

000522 00000000000000000000 

000523 00000000000000000000 

000524 OOOOOOOOOOOOOOOOOOOO 

000525 OOOOOOOOOOOOOOOOOOOO 



LB2W 
LB3W 
PPDW 



Page Boundary 



RA = CP,2. 
0OO0000 CM 



EXPRESS 00 
20.25.52. 80/01/12. (6) CYBER 174 S/N 620 DEVEL . 



DSDI - V2.0 

NOS 1-lB"' 



CP ACCUMULATOR 0000000000 

CHARGE/ACCOUNTING FLAG FPFW 000461 
ACCOUNTING FLAG/RESERVED 000 

SRU VALIDATION LIMIT 7777 

FNT ORD PROFILE FILE 0000 

LEVEL-3 BLOCK TRACK 0000 

LEVEL-3 BLOCK SECTOR 0000 

MAX FL FOR JOB STEP FLCW 000462 3777 
INITIAL FL FOR JOB STEP 0600 

MAXIMUM FL FOR ENTIRE JOB 3777 

ROLLIN FL 0000 

FL INCREASE REQUEST 0000 

JOB STEP MAX ECS FL ELCW 000463 0000 
LAST CARD ECS FL 0000 

JOB MAX ECS FL 0000 

ROLLIN ECS FL 0000 

ECS FL INCREASE REQ 0000 

ROLLOUT ALLOWABLE SSCW 000464 0000 

CONNECTION/WAIT RESPONSES 0000000000000000 

TXOT SUBSYSTEM TXSW 000465 00 

LIST OF FILES ADDRESS LOFW 000000 

INTERRUPT ADR/PREV ERR TIAW 000000 

OUTPUT POINTER TIOW 000000 

AUXILIARY PACKNAME PFCW 000466 20010 313440600 
EST OF FAMILY DEVICE 01 

LIMIT FOR SIZE OF DAF 

LIMIT FOR NUMBER OF PF 

LIMIT CUMM SIZE IAPF 

LIMIT FOR SIZE OF IAPF 

USER NUMBER UIDW 000467 00000000000000 

USER INDEX 000001 

NO EXIT AND RPV FLAGS EECW 000470 00 

00 
REPRIEVE DATA 0000 

TERMINAL INPUT POINTER TINW 000000 

REPRIEVE DATA 000000 

INPUT FILE FST TFSW 000471 6705 
PRIMARY FILE FST 0000 

RESERVED 00 

EVENT DESCRIPTOR TERW 000000 

ROLLOUT TIME PERIOD 0000 

RESERVED CSPW 000472 0000 



:ONTROL STATEMENT BFR 



A8A8| 



80/01/31. 
/R4B. 

000526 
000527 
CSBW 000530 
000531 
000532 
000533 
000534 
000535 
000536 
000537 
000540 
000541 
000542 
000543 
000544 
000545 
000546 
000547 
000550 
000551 
000552 
000553 
000554 
000555 
000556 
000557 
000560 
000561 
000562 
000563 
000564 
000565 
000566 
000567 
000570 
000571 
000572 
000573 
000574 
000575 
000576 
000577 



08.35.17. 



oooooooooooooooooooo 
oooooooooooooooooooo 

01242401031056172014 
54162014502516541411 
02220122315700000000 
01242401031056233123 
02540616172324302450 
25165413221716151704 
57550000000000000000 
47552001031334025503 
17152017231124055520 
14550124240103100504 
57550000000000000000 

oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 
oooooooooooooooooooo 



ATTACH, OPL 

=NPL/UN=LI 

BRARY. 

ATTACH, SYS 

B=FNOSTXT/ 

UN=KRONMOD 

* PACK IB C 
OMPOSITE P 
L ATTACHED 



End of T List Option 



10-36 



60455380 F 



EOR FLAG/CS COUNT 40000000 

NEXT STATEMENT INDEX 0143 

LIMIT INDEX 0143 

INPUT/SKIP FLAGS CSSW 000473 A7 > 


EQUIPMENT NUMBER 01 
FIRST TRACK 4270 
CURRENT TRACK 4270 
CURRENT SECTOR 0001 
FIRST/SECOND HALF FLAG 0001 II T option resumes at top of right 



DAYFILE POINTERS AND BUFFER-* A List Option 



column on first page in sequence. 



0006446 0002 0170 0000 0000 0046 BA - 0006450 0000 0000 0000 0000 0003 

0006447 0000 0000 0114 0000 0000 AL 

Page Boundary 



RA = 
0000000 



EXPRESS 00 DSDI - V2.0 80/01/31. 08.35.18. 
20.25.52. 80/01/12. C6) CYBER 174 S/N 620 DEVEL. NOS 1-1B«k/R4B. 



0020170 55353357333657403557 04112357000000000000 55353357333657403557 23052420225635570000 20 . 03 . 52 .DIS. 20 . 03 . 52 .SETPR, 2 . 

0020174 55353357333657403557 23251151335200000000 55353357333657403557 22052425221651111620 20 . 03 . 52.SUIC0) 20 .03 . 52 .RETURNCINP 

0020200 25245200000000000000 55353357333657403557 22061451334133333333 52000000000000000000 UT) 20 .03 . 52 .RFLC060000) 

0020204 55353357333657403557 04112357000000000000 55353357333657404057 23251156345700000000 20 . 03 . 52 .DIS . 20.03.55.SUI, 1 . 

0020210 55353357333757333457 20010313160115562001 03134406570000000000 55353357333757334257 20 . 04 . 01 .PACKNAM,PACK9F . 20.04.07. 

0020214 07052456030303030303 03540334570000000000 55353357333757343757 22052324012224560303 GET,CCCCCCC=C1 . 20 .04. 14. RESTART, CC 

0020220 03030303035700000000 55353357333757344157 55041123330105105555 22052324012224050455 CCCCC . 20.04.16. DIS0AEH RESTARTED 

0020224 06221715000000000000 55353357333757344157 55433350333450343557 55344357344257403357 FROM 20.04.16. 80/01/12. 18.17.50. 

0020230 00000000000000000000 55353357334257344457 55200615551114140507 01145522052125052324 20.07.19. PFM ILLEGAL REQUEST 

0020234 56555501245533333340 35375755000000000000 57000000000000000000 55344357354157363357 , AT 000524. . 18.26.30. 

0020240 01052322565555555555 34415740443625162423 57000000000000000000 05550317152014052405 AESR, 16.593UNTS. E COMPLETE 

0020244 57000000000000000000 55344357353757343357 30050411245623172522 03055754145027122350 . 18 . 24 . 10 .XEDIT, SOURCE. =L/WJS/ 

0020250 54302100000000000000 55344357353757354157 23251156353335415700 00000000000000000000 =XQ 18.24. 26. SUI, 2026. 

0020254 55344357353757363357 22052711160456475700 00000000000000000000 55344357353757363357 18 . 24 .30 .REWIND, K . 18.24.30. 

0020260 55555537550611140551 23525520221703052323 05045700000000000000 553443573537^7565557 4 FILECS) PROCESSED. 18.24.32. 

0020264 03012414112324570000 55344357353757363557 55030124141123245503 17152014052405570000 CATLIST. 18.24.32. CATLIST COMPLETE. 

0020270 55344357353757374257 07052456013522052324 02570000000000000000 55344357354057334057 18 . 24.47 .GET, A2RESTB . 18.25.05. 

0020274 23251156365635335700 00000000000000000000 55344357354057344357 07052456015401352205 SUI, 3320. 18 .25 . 18 .GET,A=A2RE 

0020300 23240257000000000000 55344357554057353657 07052456220523240211 16570000000000000000 STB. 18 . 25 . 23 .GET,RESTB!N. 

DAYFILE LINES IN BUFFER 

20. 03. 52. DIS. 

20. 03. 52. SETPR, 2. 

20.03.52.SUICO) 

20 . 03 . 52 .RETURNC INPUT) 

20.03. 52. RFLC060000) 

20. 03. 52. DIS. 

20. 03. 55. SUI, 1. 

20.04.01.PACKNAM,PACK9F. 

20 .04.07 .GET,CCCCCCC=C1 . 

20 . 04 . 14 .RESTART,CCCCCCC . 

20.04.16. DIS0AEH RESTARTED FROM 

20.04.16. 80/01/12. 18.17.50. 

20.07.19. PFM ILLEGAL REQUEST, AT 000524. 

ATTACHED FILES 

0011 INPUTS IN FNT - 6704 1116 2025 2447 0001 0002 INPUT* A B EST - 6562 6200 0705 0000 0415 0773 GE DMG 
FST - 6705 0001 4264 4264 0002 0005 A7 7 BE 
TRACK CHAIN - 
4264 0002 

0020 OUTPUT PR FNT - 6722 1725 2420 2524 0000 0202 OUTPUT BB EST - 6562 6200 0705 0000 0415 0773 GE DMG 

FST - 6723 7101 4267 4267 0003 0307 A7 7 CCG 
TRACK CHAIN - 
4267 0003 

0021 INPUT LO FNT - 6724 1116 2025 2400 0000 1502 INPUT MB EST - 6563 6200 0507 0000 0415 1062 EG DMH 

FST - 6725 7102 4130 4130 0002 0301 B6X6X BCA 
TRACK CHAIN - 
4130 A0U2 
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Example 4: 

The following sample illustrates the printer output listing produced by the MST directive (dump mass 
storage/track reservation table). The MST is listed in two columns. The left column is read from top to 
bottom, perhaps across page boundaries, and continues at the top of the right column. The track 
reservation table is listed in single column following the MST. 



RA = MST. 

0000001 DM 



dump mass storage tables. express 02 

0*. 34.25. 77/09/14. cdc h'jlti-mode operating system. 



DSOI - V2. 
NOS 1 



77/09/16. 16.5lt.35. PAGE 15 
1AJ HUNG USING EHC MACHINE 



SDGL 004412 00000000 



00 



3000000000 



4L3L 004413 4413 



00 



EQUIPMENT 00 - *4SS STORASE TABLE 

NUMBER AVAILABLE PRUS TQSL 004410 00364060 
LENGTH Q- TRT 05 30 

C IRST 4VAIL T^ACK PT" (,13,, 

NUN AVAILABLE TRACKS 22?0 

RESERVED ACGL 004411 0300 

DA ECS C4AIN FIRST TRACK 0080 

OIPECT ACCESS FILE CNT 0J1 6 

FIRST TRACK ID.FT 0000 

REDEFINITION STATUSES 0l 

°F UTILITY INTERLOCK 
ECS ADDRESS HST/TRT 
ECS UPDATE CTJNT 
MACHINE MASK INTERLOCK 
FIRST TRACK I APF 

LABEL TRACK U000 

FIRST TRACK "ERMITS (,1,11, 

NUMBER CATALOG TRACKS 0020 

FIRST TRACK DAT oa0 o 

FAKILr OR PACK NAME PFGL 001.1.14 23312324051500 
OEVICE NJHBER ni 

RESERVED 00 

REL UNIT MULTIUNTT DEV 

NUM UNIT MULTIUNIT OEV 

USER NUN PRIVATE PACK PUGL 004415 00000 00000 008 
OEVICE MASKS 177777 

FLAGS AN3 DAT INOFX MDGL 004416 0000 
FT-HT ^LAG •/* SECTOR LIMIT 0153 

8 RESERVED FOR PPR USE 3001 

RESERVED c V. °PR US C 5300 

SECTOR LIMIT 0153 

RESERVED otg L 004417 00 0000 000 000000 0100 

GLOBAL IMSTAL AREA I3GL 0044?0 00 00 03000 000 00000 
I2GL 004421 OaOOOOOOJOOOOODOOOOO 



9K5 9L P 



SYSTEM A 



TRACK RESERVATION TABLE 



004430 


♦3000 


1,372 


1.627 


1,71,6 


001.1,31 


♦ 0001, 


1,005 


1,006 


4007 


004432 


+ 0010 


1,011 


1,012 


4013 


004433 


♦ 0014 


1.015 


1,015 


4017 


004434 


♦0020 


1.021 


4022 


4023 


001.1,35 


♦ 0021, 


1,025 


1,026 


1,027 


00%<,36 


♦ 0033 


1,031 


1,032 


1,033 


001,1,37 


♦ 003<, 


1,035 


1,336 


4037 


004440 


♦ 001,0 


4041 


<,0l,2 


4043 


001,1,1,1 


♦ 00i,i, 


4045 


1,01,6 


4047 


04442 


♦ 0050 


1,051 


1.052 


4053 


001,1,1,3 


♦ 005<, 


1,055 


4056 


4057 


001, 1*1.1, 


♦ 0369 


1,061 


1,062 


4063 


001,1,1,5 


♦ 0061, 


1.065 


1,066 


4067 


001,1, (.6 


♦ 0070 


1,071 


1.372 


4073 


004447 


♦ 007<, 


1,075 


1,376 


4077 


0041,50 


♦ 0100 


1,101 


1,182 


4103 


001,1,51 


♦ S10t» 


1.105 


1,106 


4107 


Track Link 








Byt 


e Ordinal 







0023 7417 1111 1111 <\ -m*. y 

4010 0017 1111 5E5F5G5H 

4014 0017 1111 5I5J5K5L 

4020 0017 1111 5M5N505P 

4024 0017 1111 5Q5R5S5T 

4039 0017 1111 5U5V5W5X 

4034 0017 1111 5Y5Z5051 

'♦<"»• "I*? 1111 52535455 

4044 0017 1111 56575859 

4050 0017 1111 5*5-1,,^/ 

4054 0017 1111 5(5)5*5 = 

4060 0017 tm 5 5,5.5 

4064 0017 1111 5555 

4071 0017 1111 5 5 5 5 

4074 0017 1111 5 5 5 5 

M00 0017 mi 5 5 5 6 

4*04 0017 1111 6A6B6C60 

4110 0017 mi 6E6F6G6H 

Status Bits 



944 CHANNEL 

844 EQUIPMENT 

844 TRACK 

844 SECTOR 

844 OEVICE STATUS 

UNIT RES INTERLOCKS 

RESERVEO 

CH 2 ACCESS 7154 FLAG 

CH 1 ACCESS 7154 FLAG 

CH 4 ACCESS 7154 FLAG 

CH 3 ACCESS 7154 FLAG 

RESERVEO 

ALGORITHM INDEX 

OAYFILE TRACK 

ACCOUNT FILE TRACK 

ERPLOG TRACK 

SYSTEM TABLE TRACK 

FAMILY IOLE STATUS 

FAMILY ACTIVITY COUNT 

LOCAL STATUS FLAGS 

RESERVEO 

ERROR STATUS 

MACHINE ID 

CURRENT USER COUNT DAF 

NEXT EQUIPMENT 

ORIGINAL NUM3ER UNITS 

LOCAL STATUS 

REDEF IN PROG/NULL EQ 

RESERVEO 

NUMBER PHYSICAL UNITS 

EQUIPMENT UNIT LIST 

LOCAL INSTAL A?EA 



OSLL 004422 0077 



OILL 004423 000 



DULL 004424 40fll 



STLL 004425 2002 



0000 



00 



0000 



oootroo 



5A5B5C+7 



4003 



4542 



0101 



DDLL 004426 
- 1 00 

000000000000000s 

ISLL 004427 0000 000030 0000000000 
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Example 5: 

The following sample illustrates the printer output listing produced by the C, D, and E memory dump 
directives (instruction parcel, byte, and word format, respectively). The same portions of central 
memory are dumped in each format. Auto page eject has been disabled via the EJOFF directive to allow 
listing the output from all three memory dump directives on one page. 



»A = C, 3100,31*0. C - FORMAT OUMP. EXPRESS 02 

0000000 CM 0«.3*.25. 77/09/11. .COC MULTI-M00E OPERATING SYSTEM. 



»2. 

3S 1 



77/09/16. 16.5*. 35. PAGE 27 

1AJ HUNG USING EHG MACHINE 



000 3100 
0003101 
0003102 
0003103 
0003101. 
0003105 
0003106 
000 3107 
0003110 
0003111 
0003112 



000 3100 
0003101 
0003102 
0003103 
0003101. 
0003105 
0003106 
0003107 
0003110 
0003111 
0003112 



0003100 
0003101. 
0003110 
0003111. 
0003120 
0003121. 
0003130 
0003131. 



00000 
00000 
07172 
00000 
00000 
00000 
55555 
55555 
00000 
00000 
31.152 

CM 

0000 
0000 
0717 
0000 
0000 

ooos 

5555 
5555 
0000 
0000 
31.15 

CM 

00000 
00000 
00000 
60000 
00000 
60000 
00000 
60000 



00000 00000 03130 YX 

00000 00003 00000 

1.1756 35575 50000 GOTO, 2. 

00000 00002 72500 WU 

00000 61002 721.03 WTC 

00000 00000 00000 

55531. 1.0571. 01.337 15.551. 

55555 33573 331.1.0 0.015 

00000 00000 03050 X/ 

00000 00000 00000 

1*1013 13000 00001 1MTHKK 4 



0003113 30160 07600 22000 00153 N R A$ 

0003111* 60000 00000 00002 00010 P H 

0003115 00000 00000 00000 00000 

0003117 55555 55555 33573 3331.0 0.005 

0003120 00000 00000 00000 0311.0 Y5 

0003121 30000 00000 00000 00000 

0003122 3*152 1*1030 12000 00001 1MTHXJ A 

0003123 00100 07600 22000 00000 H R 
0003121* 60000 00000 00002 00010 P H 
0003125 00090 00030 00000 00000 



0003126 
0003127 
0003130 
0003131 
0003132 
0003133 
000313* 
0003135 
0003136 
0003137 



55555 55555 31*571* 3361*2 1.337 

55555 55555 33573 3351.0 0.025 

00000 00000 00000 03120 YP 

00000 00000 00000 00000 

31*152 1.1030 12000 00001 1MTHXJ A 

00000 00000 00500 3001*7 /C * 

60000 00000 00002 00010 P H 

00000 00000 00000 00000 

55555 55555 33573 71*237 0.1,7* 

55555 55555 33573 33637 8.031* 



D, 3100,311*0. - FORMAT OUNP. 



0000 0000 0000 3130 YX 

0000 0000 0000 3000 

21*17 5635 5755 0000 GOTO, 2. 

0000 0CO0 0027 2500 W'J 

0000 3061 0027 21*03 WTC 

0000 0000 0030 0300 

5555 3l*l»0 571*0 1*337 15.5S<* 

5555 5533 5733 31*1.0 0.315 

DO00 0030 0000 3050 X/ 

0000 0000 0000 0000 

21*10 1313 0300 0001 1HTHKK A 



0003113 0016 0076 0022 0300 0153 

3003111* 6303 0300 0000 3020 0010 

0003115 0000 0000 0000 0300 0000 

3003117 5555 5555 5533 5733 33*0 

3303120 3030 0000 0030 3000 311*0 

0003121 0003 0000 0000 0000 0000 

0003122 3(*15 21*10 3012 0000 0001 1HTHXJ 

0003123 0010 0076 0022 0000 OOuO 
000312!* 6003 0000 0000 0020 0010 
0003125 0000 0000 0000 0000 0000 



R 


At 


0003126 


5555 


5555 


5 531* 


571*3 


361*2 


1. 


,837 




P H 


QQ03127 


5555 


5555 


5533 


5733 


351*0 


0, 


,025 






0003130 


0000 


0000 


0000 


0000 


3120 




YP 






0003131 
0003132 


0000 
31*15 


0000 
21*10 


0003 
3012 


0000 
0000 


0000 
0001 


1HTHXJ 




3, 


.005 


A 




Y5 


0003133 


0000 


0000 


0000 


5003 


001*7 


/C * 






000313* 


6000 


0000 


0000 


0020 


0010 




P H 


J 


A 


0003135 


0000 


0000 


0000 


0000 


0000 


















5737 


1*237 


n 


i 1*71* 


R 




UUUJUQ 


o??o 


3PS3 












P H 


0003137 


5555 


5555 


5533 


5733 


3637 


V. 


.031* 



E, 3100. 3H*0. 



■ORMAT 0UM°. 



300000000003130 
0000061002721.03 
000000000003050 
000000000200010 
00000000000311*0 
QOO00OG002OOO1O 
000000000003120 
000000000200010 



00000 0000 00 00000 00 
000000000 00 330303000 
00000 00 0000000000 00 
00033300000030000000 
000000000 00 000000000 
00 3030030 00 030330000 
000000000 00 000000 000 
33030000000000000 000 



071721.17563557550000 
5 555555 531*1*0571*31*33 7 
31*1521*10131300000001 
03300033000000000000 
31*1521*10 30120 0000001 
5 5555555 5531.571*3361*2 
31*1521*10301200 30 0001 
5 5555555553357371*237 



000030300000 
555555555533 
001630763022 
555555555533 
001030760322 
555555555533 
000000000030 
555555555533 



00272500 
573331*1*0 
30000153 
5733331*0 
03300000 
5733351*0 
5003001*7 
57333637 



WTC 
X/ 



GOTO, 2. 

15.58"* 




HU 
0.015 


1MTHKK A 


N 


R At 

0.005 


1MTHXJ A 
1.837 


H 


R 

0.025 


1MTHXJ A 




/C ♦ 



0.031* 



Example 6: 

The following sample illustrates the printer output listing of the FNT interlock table produced by the 
FNT CMR dump directive. The file name/file status table, which is also produced, is in the same format 
as that produced by the D memory dump option (example 5). 



(?A = FNT. 

0000000 CM 



EXPRESS 02 
08.3*.25. 77/09/H*. COC M'JLTI-HOOE OPERATING SYSTEM. 



OSDI - V2.0 
NOS 1 



77/09/16. 16.54.35. PAGE 28 

1AJ HUNG USING ENC HACHINE 



FNT INTERLOCK TABLE 

000<*37!» 0000 0000 0000 0000 0000 

0001*375 0000 0000 0090 0000 0000 

0011*376 0000 0000 0000 0000 0000 

0001*377 0000 0000 0000 0020 0000 /3731*/ 

0001*1*00 0000 0000 0000 0000 0000 

0001*1*01 0000 0000 0000 0000 0000 

0001*1*02 0000 0000 0000 0000 0000 

0001.1.03 0000 0000 0000 0000 0000 

FILENAME TABLE 

0003371* 2331 2321* .515 0001 1600 SYSTEM AN 0003«*,6 0000 0000 0000 0000 0000 ..»** WJ M-J «•• •••• »JJ DO^ M 

0003375 0000 <*00l* *00* 0001 0005 5050 A E 

0003376 2601 1*11 0*25 3200 1300 VALIDUZ K 



00031*52 171* 0*20 1*00 0001 1212 OL3PL AJJ 000355* 0000 0000 0000 0000 0000 
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STATUS/CONTROL REGISTER SIMULATOR 11 



Error logging on a CYBER 170 enables the occurrence of channel parity, memory parity, and other errors 
identified in the status/control (S/C) register to be detected and logged. The status/control register 
simulator (SCRSIM) allows the user to set S/C register bits in order to aid in the testing of error logging 
and error recovery procedures. 

SCRSIM runs on CYBER 170 machines using the S/C register on channel 16 and if more than 10 PPUs are 
available on the machine, the S/C register on channel 36. On CYBER 70 machines, SCRSIM uses the 
interlock register on channel 15. 

With the aid of a K display, the user can specify commands to set and clear bits, set bytes, and set lines 
and areas in holding registers. This allows both S/C registers to be set up completely. The contents of 
the holding register can then be transferred to the S/C registers (64 or 128 bits are transferred to the 
interlock register of a CYBER 70). 

The bits set through this simulator are logged in the error log if an error bit is set, thus aiding in testing 
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significance of each S/C register bit.) The simulator job dayfile lists all simulator commands entered. 
This error logging does not occur in a CYBER 70, however, unless an appropriate IPRDECK entry has 
been made (refer to CYBER 70 Use). 



NOTE 



Extreme care should be taken when using the 
simulator. Improper use may result in serious 
system malfunctions. 



Refer to appendix A for descriptions of messages produced by SCRSIM. 

USING THE SIMULATOR 

CYBER 70 USE 

Error logging is always enabled on a CYBER 170; however, a zero TC (threshold count) parameter in the 
DELAY IPRDECK entry (refer to the NOS Installation Handbook) disables error logging on a CYBER 70. 
Although the default threshold count is zero, at deadstart time this parameter can be set to any value 
from to 7777g. Any nonzero threshold count enables error logging on a CYBER 70. 

Although the simulator operates on a CYBER 70 if the threshold count is left at zero, it only manipulates 
bits in the interlock register. No error logging occurs. 
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CONSOLE OPERATION 

The simulator is called from the console by entering: 

X.SCRSIM. 
The simulator left K display (figure 11-1) appears on the left screen after entering 

K,n. 

where n is the control point number noted on the B display. This K display shows the contents of the 
temporary holding registers, as well as a central memory buffer. This buffer contains the following. 

• A history of all error status bits since the last level deadstart. If an error status bit has been 
set in the S/C register, it remains set in the buffer, even though it may have been cleared in the 
actual S/C register. This history may be useful in diagnosing system malfunctions. 

• All other bits in the buffer reflect actual values in the S/C register at the time the last error 
bit was set. Each time an error bit is set, the entire buffer is updated. 

Unless the simulator is running on a CYBER 170 with more than 10 PPs, the message 

CHANNEL 36 NOT AVAILABLE 

also appears. This indicates that no channel 36 S/C register is present on the machine, and thus, no 
simulation need be done for it. 

By entering 

KK. 

the simulator right K display (figure 11-2) is brought up on the right screen. This display gives a brief 
description of the commands available. 

Commands can be entered on the K display by entering 

K.command. 

where command is one of the commands shown in figure 11-2. 

BATCH INPUT 

The simulator may also be called from batch input by the control statement SCRSIM. The input file must 
have a record containing the commands to be processed, one command per card. The system must be in 
debug mode and the user must be validated for system origin privileges. 
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TEMPORARY HOLDING REGISTER CONTENTS 
CHANNEL 16 REGISTER - LINES 0-3 



BITS 59- BYTE 00 

000000000000 000000000000 000000000000 000000000000 000000000000 
0000 0000 0000 0000 0000 



BITS 119- 60 BYTE 05 

000000000000 000000000000 000000000000 000000000000 000000000000 
0000 0000 0000 0000 0000 



BITS 179-120 BYTE 10 

000000000000 000000000000 000000000000 000000000000 000000000000 
0000 0000 0000 0000 0000 



BITS 203-180 BYTE .15 

000000000000 000000000000 
0000 0000 



CHANNEL 36 NOT AVAILABLE 



ACTUAL S/C REGISTER ERROR BUFFER 

CHANNEL 16 REGISTER - WORDS 113-116 

000000000000 000000000000 000000000000 000000000000 000000000000 

000000000000 000000000000 000000000000 000000000000 000000000000 

000000000000 000000000000 000000000000 000000000000 000000000000 

00Q000000000 000000000000 



Figure 11-1. Simulator Left Display 



60455380 A H_3 



COMMAND 
AREA, A, M, Y. 
BYTE, XX, YYYY. 
CLEAR, A, B, . . .,Z, 
CYCLE,X,T,R. 
END. 

LINE,X,Y. 
READ. 
SET,A,B,...,Z. 

+ . 

GO. 
STOP. 



SIMULATOR COMMANDS 

DESCRIPTION 
SET M BITS FROM A TO OCTAL VALUE Y 
SET BYTE XX TO OCTAL VALUE YYYY 
CLEAR BITS A,B, . . .,Z 
SET BIT X EVERY 16-T MS. R TIMES 
END CYCLE COMMAND BEFORE R REACHED 
SET LINE X TO OCTAL VALUE Y 
READ S/C REGISTER INTO HOLDING REGISTER 
SET BITS A,B, . . .,Z 

CHANGE REGISTER BEING USED AND K DISPLAY 

ENTER HOLDING REGISTERS IN S/C REGISTERS 
END THE SIMULATOR 



ALL BIT, BYTE, AND LINE NUMBERS ASSUMED DECIMAL. 

TIME VALUES ASSUMED DECIMAL 

Y AND YYYY VALUES MUST BE OCTAL. 



Figure 11-2. Simulator Right Display 
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SIMULATOR COMMANDS 

This section lists the commands available to the simulator user. The entire command keyword must be 
entered, and only one command may be entered at a time. Each command, except +, must end with a 
terminator. In all cases, a null argument is assumed to be zero. 



HOLDING REGISTER COMMANDS 

The following commands, except GO., affect only the holding register currently displayed on the left 
screen. These commands are used to set up the entire 204 bits in the holding registers. GO. transfers 
the holding register contents to the actual S/C register. (On a CDC CYBER 70, the channel 16 S/C 
register is simulated by the interlock register. GO. transfers the first 64 of 128 bits of the holding 
register to the interlock register.) The current contents of the holding register is displayed in binary and 
octal on the left screen (refer to figure 11-1). The contents of the actual S/C register are also displayed 
in binary on the left screen. 

Command Description 



AREA,a,m,y. Set m bits in the holding register, from bit a to bit a+m-1, to the 

octal value y. 

a Starting bit number, which may range from to 203. a 

is assumed to be decimal, but a postradix of D or B 
may also be included. 

m Number of bits to be set. m is assumed to be decimal, 

but a postradix of D or B may also be included. 

y Value to which the bits are to be set. y may be up to 

m bits of octal value. 

BYTE,xx,yyyy. Set byte xx in the holding register to the octal value yyyy. 

xx Byte number which may range from to 16. xx is 

assumed to be decimal, but a postradix of D or B may 
be included. 

yyyy Value to which byte xx is to be set. yyyy may be up to 
12 bits of octal value. 

CLEAR,a 1 ,a2,— »a n - Clear bits ai,a2,—,a n in the holding register. If more than 30 bit 

numbers are entered, only the first 30 are processed. All others are 
ignored. 

a\ Bit number, from to 203, to be cleared. A decimal 

value is assumed, but a postradix of D or B may be 
included. 
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Command 



LINE,x,y. 



READ 



SET,a 1 ,a 2 ,—,a n . 



Description 

Set line x of the holding register to the octal value y. 

x Line number, ranging from to 3, of the holding 

register shown on the left display screen (refer to 
figure 11-1). Line is positioned at the top and line 3 
is positioned at the bottom. 

y Value to which line x is to be set. y may be up to 60 

bits of octal value. 

Transfer the contents of the actual S/C register to the holding 
register. 

Set bits ai,a2,"*,a n in the holding register. If more than 30 bit 
numbers are entered, only the first 30 are processed. All others are 
ignored. 



GO. 



a,- Bit number, from to 203, to be set. A decimal value 

is assumed, but a postradix of D or B may be included. 

Transfer the contents of the holding register to the actual S/C 
register or the interlock register of a CYBER 70. No bits in the 
holding register are changed by this command. 



CYCLE COMMANDS 

Command 
CYCLE,x,t,r. 



END. 



Description 

Set bit x every t periods of time, a total of r times. This command 
assumes control of the simulator for the total time period specified. 
During this time, no command is accepted except END. Bit x is set 
in the holding register by this command. 



x Bit number, from to 203, to be set. 

t Number of periods of time for each cycle, one period 

being 16 milliseconds. t=32 is approximately 0.5 
second. 

r Number of times to set bit x. r may not exceed 4095. 

End CYCLE command processing before r is reached. Control of the 
simulator is returned to the operator. 



+ AND STOP. COMMANDS 



Command 



+. 



STOP. 



Description 

Toggle the K display between the channel 16 and channel 36 register 
displays and also change the register currently being worked on, if 
the simulator is being operated on a CYBER 170 with two S/C 
registers. If two S/C registers are not present on the machine, no 
action is taken. The channel 16 register is assumed when the 
simulator begins. The only holding register which is affected by the 
holding register and cycle commands is the one currently displayed. 

End simulator processing. 
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INSTALL 12 



NOS allows multiple copies of the running system to reside on several mass storage devices of the same 
type. The system deadstart file (SDF) is defined to be a copy of the deadstart tape that resides on a 
rotating mass storage (RMS) deadstart device. When the system is deadstarted from disk, this file is read 
to generate copies of the running system. 

There are two ways to install an SDF on a mass storage device, via CMRDECK processing (refer to the 
NOS Installation Handbook) or by a system origin job using the INSTALL control statement. 

The INSTALL control statement installs a copy of the running system, or alternately a user specified 
deadstart file, from mass storage to a rotating mass storage deadstart device. The RMS device selected 
must be on, available, a single unit device such as an 844 or 885, and must have common test and 
initialization (CTI) installed. (For more information about CTI, refer to the NOS Operator's Guide.) If 
the RMS deadstart device is a shared (MMF) device, a full INITIALIZE must have been previously done. 
The calling job must be system origin or the user must be validated for system origin privileges. DEBUG 
must be set if the job is not initiated from the console. 

The format of the control statement is: 

INSTALL,filenam,EQxx. 

filenam Mass storage file (assigned to the control point) to be installed as an SDF. Default 

is SYSTEM, which must be assigned to the control point. SDF is a reserved file 
name and cannot be specified for filenam. 

If the deadstart file to be installed is on tape, it must first be copied to mass 
storage before INSTALL can be used. 

xx One- or two-digit (octal) EST ordinal of the RMS device on which filenam is to be 

installed. 
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881/883 PACK REFORMATTING UTILITY 13 



nnL^i R ?9 mn ? V* f 4 ^ 181 ' St0mge subs y stem contain s factory-recorded flawing information 
on cylinder 632o (410 10 ), track 0, sectors 0, 1, and 2. Each 883 pack contains this information on 

c linders (822 10>> track °» sectors 0, 1, and 2. The foUowing information is included on the 

• Cylinder 632 8 (or 1466 8 for 883 packs), track 0, sector contains the factory-recorded 
manufacturing data. This data consists of the pack serial number and the manufacturing date. 

• Cylinder 632 8 (or 1466 8 ), track 0, sector 1 contains the factory map. This map contains a list of 
all factory-detected flaws, both correctable and uncorrectable. 



• Cylinder 632g (or 1466 8 ), track 0, sector 2 contains the utility map. This map originally 
contains aU factory-detected uncorrectable flaws. This map is updated by the reformatting 
utility. 5 

FORMAT* iS a CDTl r\ns\rrnam wHl nh AnQT-otoC in --k~~ ,•,,.-. «.•(-:,.., ,..I4.V. T5T-\T^ _ T-»T1 _.- - -- . ... 

~>f™»«+ qTTiTom*^ p^b*" 6 "" "\"~" ~t~»—~' *« wiijuiiciiuii wiui rur, a rr program, io maintain and 
reformat 881/883 disk packs. It is used to perform the foUowing functions. 

• Factory-recorded manufacturing data, factory-recorded flaw data, and utility flaw data can be 
retrieved from a factory-formatted disk pack. 

• Sector and track flaws can be set or cleared on a factory-formatted disk pack. 

• Address fields of a previously factory-formatted disk pack can be restored. (This function is 
used only in the event that addresses on the pack are lost.) 

In order to function, FORMAT requires that the factory-recorded data (sectors and 1 of cylinder 632o 
(or 1466 8 ) be correct and readable. The pack cannot be processed if this data is unreadable. If packs are 
available which do not contain this factory recorded information, consult a customer engineer to have 
SS»2 A < 5 E ! at J 0n P} ace6 ° n } he Pack 8 - Also, the correct level of controlware must be present in order for 
FORMAT to function. To determine the controlware level and for procedures to install this controlware 
refer to the NOS Installation Handbook. Since the operating system requires that the utility map contain 
the physical flaw information in order for automatic logical flawing to be performed, it is important that 
the utility map be properly maintained. 

The operating system automatically sets logical flaws when initializing 844 equipment. This is done bv 
reading the utility map of the 844 units involved, and mapping this physical flaw information into the 
corresponding logical track addresses. Logical track flaw reservations are then made in the track 
reservation table (TRT) for the 844 equipment being installed. For example, if the 844 equipment beimr 
initialized consists of two physical units (such as a DI-2 configuration), the logical flaws set in the TRT 
are obtained from the physical flaw information recorded in the utility maps of both units making up the 
DI "2 configuration. This automatic flawing occurs when an equipment is initialized, regardless of 
whether the initialization is done during deadstart, on-line, or is the result of running FORMAT 
Automatic flawing also occurs when an X.FLAW request is made from the console. 
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The operating system allows for the manual setting and clearing of flaw information. The STK 
CMRDECK entry manually sets or clears logical track reservations in the TRT of the equipment. (Refer 
to the NOS Installation Handbook for information concerning these entries.) If the device is then 
checkpointed, this flaw information is preserved in the TRT portion of the device label. The STK entry 
can be made during deadstart, during on-line initialization, or by using the FLAW utility (as described in 
the NOS Operator's Guide). In any case, the flawing done via these entries is only logical; the flaw 
information remains only in the TRT and is discarded on subsequent deadstart initialization unless 
manually reentered. This information is also lost during on-line initializations if it was not possible to 
recover the equipment. The use of STK does not cause any additional information to be recorded in the 
utility map; only FORMAT is capable of updating the utility map data. Caution should be taken if 
attempts are made to cancel a logical flaw that was made during automatic flawing, since the physical 
disk sector is still marked as flawed and attempts to access that sector yield error conditions. 

The following sections describe the use of the FORMAT utility for maintaining and reformatting 881/883 
disk packs. 



FORMAT CONTROL STATEMENT 

Processing of maintenance operations on an 881/883 type disk pack is initiated by the FORMAT control 
statement. This program interfaces with the operator and a PP program FDP. The format of this 
statement is: 

FORMAT( Pl ,p2,...,Pn) 

where each pj is a keyword or a keyword equated to a value. 



G=m 

I=filenam 
I 

L=filenam 

L 
MODE=mode 



Description 

Relative unit of a multispindle device. This value is checked for validity 
within the device. For example, if the device is a DI-2 and G=2 is specified, an 
error results. 

File on which input directives and data is written. 

Same as I=INPUT. 

Output file on which the information extracted from the disk pack is to be 
written. (Refer to NOTE after 0=filenam option.) 

Same as L=OUTPUT. 

Operational mode for FORMAT. 

Mode Description 

ALTER The input file contains directives to control the set or clear 

flaw operations (refer to Input Formats). 

FETCH The information contained on the factory sectors cylinder 

632g (or 14668), track 0, sectors 0, 1, and 2 is obtained and 
copied to the output file (and optional output file, if 
available). 

RESTORE The addresses, flawed sectors, and tracks are restored 
according to information given in the utility flaw map. If 
the utility flaw map is not intact, the program aborts. 
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MODE 
0=filenam 



Description 
Same as MODE=FETCH. 
Optional output file to contain the output extracted from the disk pack. 



NOTE 



If output files other than OUTPUT or optional 
output files are specified, they should be created 
prior to the initiation of FORMAT. If they are not, 
they are destroyed upon completion of FORMAT 
processing. 



P=serialn Pack serial number in decimal of the pack to be processed. If serialn does not 

match the serial number recorded on the disk pack at the factory, processing 
does not occur. 

r» o-~— „„ r»_n 

r oanic aa r— u. 

U=xx EST ordinal in octal of the 844 on which the disk pack is mounted. The unit is 

checked to ensure that it is available for formatting (refer to Accessing Mass 
Storage Devices later in this section). 

V Specifies that the utility is to verify the addresses recorded on the disk pack. 

This option is valid only if MODE=FETCH or MODE=RESTORE is specified. 

If all default values are used, the following call is made. 

FORMAT(I=INPUT,L=OUTPUT,MODE=FETCH,P=0) 

At least the U and the P parameter must be correctly specified to initiate processing. 

INPUT FORMATS 

Input to FORMAT consists of control directives and data statements. Control directives indicate the 
type of operation to be performed. Data statements indicate locations on the pack where the operations 
are to be performed. A number of data statements may follow each control directive. Control 
directives and data statements are contained on the input file. This file is accessed only when 
MODE=ALTER has been specified on the FORMAT control statement. The input file (and therefore, 
control directives and data statements) has no significance when MODE=FETCH or MODE=RESTORE is 
specified. 
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CONTROL DIRECTIVES 

Control directives begin in column 1. The format is: 

directive 
The following are acceptable directives. 

Directive Description 

SET Declares that the following data statements contain the addresses of flaws to 

be set and entered in the utility flaw map. 

CLEAR Declares that the following data statements contain the addresses of flaws to 

be cleared and deleted from the utility flaw map. 

FINIS Declares the end of the input. No information following this statement is 

processed. This directive is optional. 

SET and CLEAR directives may be intermixed in the input file. However, all CLEAR operations are 
performed before any SET operation. Any attempt to alter the factory map or to set or clear sector 
I flaws in a previously flawed track, results in an error. 



DATA STATEMENTS 

Data statements begin in column 1. The format is: 
x,cccc,tt,ss 

x Type of flaw to be set or cleared. Acceptable values are: 

— Description 

S Indicates that the SET or CLEAR directive is applied to a sector. 

T Indicates that the SET or CLEAR directive is applied to a track. 

cccc Octal number specifying the cylinder; the range is from to 632q (or 1466q for 

883 packs). ° 

tt Octal number specifying the track; the range is from to 22 8 . 

ss Octal number specifying the sector; the range is from to 27 8 . This field is 

ignored for track flaws (x=T). 

All input data is checked to ensure that the values are within range. Any errors in input result in the 
termination of the utility before the disk is accessed. Any attempt to alter the factory map, or to set or 
clear sector flaws in a previously flawed track results in an error. 

A maximum of 157 data statements can appear in the input stream. 
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OUTPUT FORMATS 

Output generated by FORMAT is always placed on the output file (L=filenam on the FORMAT control 
statement). This file, for all modes of operation (ALTER, FETCH, and RESTORE), contains the following. 

• A listing of the input stream, if any. 

• The pack serial number and date of factory formatting from the manufacturing section (cylinder 
6328 or 1466s), track 0, sector 0. 

• A listing of the factor flaw map contained on cylinder 632g (or 1466s), track 0, sector 1. 

• A listing of the utility flaw map contained on cylinder 632s (or 1466s), track 0, sector 2. 

• A listing of the utility flaw map following any changes resulting from SET or CLEAR 
directives. This listing appears only when MODE=ALTER is specified on the FORMAT control 
statement. 

• A listing of the flawed sectors and tracks as read from the disk during address verification. 
This listing appears only when MODE=FETCH or MODE=RESTORE, and the V option are 
specified on the FORMAT control statement. 

Rpfpr fn F.Ynmnlps fnr pYamnloc nf otanrlor*/-! nii-f-rm+ 

The output generated by FORMAT can be directed to an optional output file (0=filenam). This file can 
then be used as input to another program, or it can be punched or printed. 



EXAMPLES 

The following three examples illustrate a series of reformatting operations performed on the same pack. 

Example 1: 

A RESTORE operation is performed on an 881 pack. A control statement similar to the following was 
entered. 

FORMAT(U=xx,P=819545,MODE=RESTORE) 

Figure 13-1 illustrates the resulting output. 

Example 2: 

The flaws noted in the factory flaw map from example 1 (figure 13-1) are now set in the utility flaw map. 

Input similar to the following was entered. 

FORMAT(U=xx,P=819545,MODE=ALTER) 

- - EOR - - 

SET 

S,626,15,15 

T,302,16,0 

T,362,01,00 

T,373,21,00 

FINIS 

- - EOI - - 

Figure 13-2 illustrates the resulting output, 
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DISK PACK REFORMATTING UTILITY -VERSION 1. 1- 78/09/05 

MODE = RESTORE 

DISK PACK SERIAL NUMBER 
819545 

DATE OF ORIGINAL FACTORY FORMATTING 
74/04/30 

FACTORY FLAW MAP 

(C = CORRECTABLE ERROR, S=SECTOR FLAW, T=TRACK FLAW) 

S, 632, 00, 00 

S, 632, 00, 01 

S, 632, 00, 02 

T, 302, 16,00 

T, 362,01,00 

T, 373, 21, 00 

S, 626, 15, 15 

UTILITY FLAW MAP 

(S=SECTOR FLAW, T=TRACK FLAW) 

MAP EMPTY 

PACK FORMATTING COMPLETE, VERIFICATION FOLLOWS 
S, 632, 00,00 
S,632, 00, 02 
S, 632, 00, 01 

ADDRESS VERIFICATION COMPLETE 

Figure 13-1. FORMAT Output, MODE=RESTORE 
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DISK PACK REFORMATTING UTILTTY 
MODE = ALTER 



■VERSION 1.1- 



78/09/05. 



INPUT DATA 

SET 

S, 626, 15, 15 

T, 302, 16, 00 

T, 362, 01, 00 

T, 373,21, 00 

FINIS 



DISK PACK SERIAL NUMBER 
819545 

DATE OF ORIGINAL FACTORY FORMATTING 
74/04/30 

FACTORY FLAW MAP 

(C=CORRECTABLE ERROR, S=SECTOR FLAW, T=TRACK FLAW) 

S, 632, 00, 00 

o con r\r\ n 1 
O, U04, uv, u± 

S, 632, 00, 02 
T, 302, 16, 00 
T, 362, 01, 00 
T, 373, 21,00 
S, 626, 15, 15 

UTILITY FLAW MAP 

(S=SECTOR FLAW, T= TRACK FLAW) 

MAP EMPTY 

UTILITY FLAW MAP (ALTERED) 
(S=SECTOR FLAW, T= TRACK FLAW) 
S, 626, 15, 15 
T, 302, 16, 00 
T, 362, 01, 00 
T, 373, 21, 00 



Figure 13-2. FORMAT Output, MODE=ALTER 



Example 3: 

A FETCH with verification operation is performed to ensure proper reformatting. A control statement 
similar to the following was entered. 

FORMAT(U=xx,P=819545,MODE=FETCH,V) 

Figure 13-3 illustrates the resulting output. 
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DISK PACK REFORMATTING UTILITY -VERSION 1 1- 78/09/0<S 

MODE = FETCH vinoiuiN i. i f8/uy/U5. 

DISK PACK SERIAL NUMBER 
819545 

DATE OF ORIGINAL FACTORY FORMATTING 

FACTORY FLAW MAP 

S?632° 0? E 00 TABLE ERROR ' S=SE CTOR FLAW, T=TRACK FLAW) 

S, 632,' 00^01 

S, 632, 00, 02 

T, 302, 16, 00 

T, 362, 01, 00 

T, 373,21, 00 

S,626, 15, 15 

UTILITY FLAW MAP 

(S=SECTOR FLAW, T=TRACK FLAW) 

S,626, 15, 15 

T, 302, 16,00 

T, 362, 01,00 

T, 373, 21,00 

ADDRESS VERIFICATION FOLLOWS 
T, 302,16,00 
T, 362, 01, 00 
T, 373, 21, 00 
S, 626, 15, 15 
S, 632, 00, 00 
S,632, 00, 02 
S,632, 00, 01 

ADDRESS VERIFICATION COMPLETE 

Figure 13-3. FORMAT Output, MODE=FETCH 
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ACCESSING MASS STORAGE DEVICES 

Special procedures must be used to access the 844 drive used in the reformatting utility. Since certain 
FORMAT operations (ALTER and RESTORE) can change addresses on the pack, user access to the pack 
must be restricted. 

FORMAT can operate on the pack in the following ways. 

• A read operation (FETCH) obtains formatting information from the pack. The integrity of the 
pack is maintained. 

• Read and write operations (ALTER and RESTORE) can set and clear flaws, and addresses can be 
rewritten. Users cannot place permanent files on the pack when these operations occur. The 
integrity of the data on the pack is lost, so a full initialization of the pack must occur before 
system usage occurs. 



ACCESS FOR READ OPERATIONS 

Accessing the pack for read operations requires that the U parameter be specified on the FORMAT 
control statement with the correct EST ordinal of the device containing the pack. In this case, the 
device must be a single-swindle device unless the G parameter is also swecified* The P n arameter must 
also be specified with the correct pack serial number. 

In addition, FORMAT must be called from one of the following. 

• A system origin job (from the console). 

• A system privileged job (in this case, engineering mode must have been selected on the system 
console). 



ACCESS FOR READ AND WRITE OPERATIONS 

In addition to the information specified for read only operations, the following additional steps must be 
taken to access a device when write operations (ALTER and RESTORE) are to be performed. (Refer to 
the NOS Operators Guide for a description of all DSD commands and for the mass storage status display 
and to the NOS Installation Handbook for a description of all CMRDECK entries.) 

1. The pack to be accessed should be mounted on a removable mass storage device. 

2. One of the following conditions is required. 

a. The device should not be a shared device. (Refer to SHARE command in the NOS 
Installation Handbook.) 

b. If the device is shared, a global unload should be set. (Refer to section 8.) 

3. The device must be declared logically off. Use the OFF,xx. DSD command or the OFF 
parameter in the CMRDECK EQ entry. 

4. The mass storage status (E,M.) display must show that the device is not in use. 
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5. One of the following conditions is required. 

a. The mass storage status (E,M.) display must show that the device is unavailable for 
permanent file access. 

b. The following conditions are required. 

1) The full initialize status and the format pending status must be set. Use either of the 
DSD commands, INITIALIZE,xx,FP. or FORMAT,xx. 

2) The direct access file user count should be equal to zero. The mass storage status 
(E,M.) display gives this information. 

If all the necessary conditions are satisfied, FORMAT is able to access the pack for reformatting 
purposes. FORMAT repeatedly checks to ensure that these conditions are satisfied throughout the 
FORMAT operation. 6 
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CONTROLWARE LOADING UTILITY 14 



The LOADBC control statement provides the capability of dynamically downloading disk controlware to 
the associated controller and channel. The downloading of controlware can only be initiated with a 
console command. The controlware can be loaded on a channel that is either active or down. The calling 
job must be system origin or the user must be validated for system origin privileges; and the system must 
be in engineering mode (refer to the NOS Operator's Guide). LOADBC will issue appropriate messages to 
indicate the success or failure of the controlware load attempt. 

The format of the control statement is: 

LOADBC,C=xx. Load all controlware on channel xx regardless of channel status UP or DOWN. 
Controlware is from the system file. 
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SYSTEM DATA GATHERING UTILITIES 15 



The TRACER and PROBE utilities described in this section provide data for statistical analysis of the 
system. The data is used to determine areas where problems occur, where improvements in design might 
be made, and to perform system tuning. The TRACER utility monitors the system's activity and gathers 
data periodically. The PROBE utility traps and measures particular internal events in the system. Both 
utilities capture valuable data which may not be obtainable any other way. 



TRACER UTILITY 

The TRACER utility monitors the following conditions: 
Channel activity by channel. 
Channel reserved. 
Channel requested. 

Number of active peripheral processors (PP). 

Central processor unit (CPU) use (idle system, system-related activity, or user activity). 
Subsystem CPU use. 
Storage moves pending. 
PP saturation. 
MTR cycle time. 

CPUO or CPU1 is or is not in monitor mode (CYBER 170 Series only). 
Same storage move request is pending. 
Permanent file manager (PFM) activity. 
Job scheduler activity. 
Control points in inactive (I) status. 
Control points in executing (X) status. 
Control points in waiting (W) status. 
Number of active control points. 
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• Amount of available memory. 

• Amount of memory at control points by origin. 

• Amount of memory in queue by origin. 

• Amount of memory at control points by subsystem. 

• Number of nonqueue files. 

• IAF /TELEX active users. 

• IAF/TELEX pots available. 

• IAF/TELEX pots in use. 

• Tape drives in use. 

• Tracks available by mass storage device. 
The TRACER utility includes the following programs: 

ICPD A CPU program which initiates system monitoring by CPD. 

CPD A PP program which monitors any of the system activities listed above. CPD is 

dedicated to a PP while it is monitoring system activity. Data is written to a direct 
access permanent file for future analysis. 

ACPD A postprocessor program which generates an output report from the direct access 
permanent file written by CPD. 

ENDCPD A CPU program that terminates system monitoring by CPD. 

TRACER CONTROL STATEMENTS 

TRACER control statements are described in the following paragraphs. 

ICPD Control Statement 

ICPD defines a mass storage file to which CPD will write statistical data and which will initiate system 
data gathering. 

Control statement format: 

ICPD(p 1 , P2 ,...,p n ) 

Pi Description 

FL=nnnn Fast loop time, in milliseconds, during which such variables as PPs active and 

move request pending are sampled. 
Default is 5 milliseconds. 
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ML=nnnn 

SL=nnnn 

FW=nnnn 
FN=lfn 



M=xxxx 



Description 

Medium loop time, in milliseconds, during which such variables as control 
points in I, X, and W status and FL available are sampled. 
Default is 100 milliseconds. 

Slow loop time, in milliseconds, during which such variables as IAF users and 
tape drives in use are sampled. 
Default is 1000 milliseconds. 

Data block sample time, in seconds. 
Default is 5 seconds. 

Name of sample data file. 

Default is SAMPLE. 

ICPD will attempt to attach a direct access file by this name. If no file 

exists, it will be defined. If a file is found, ICPD will skip to EOI and write an 

EOF. CPD will then start writing data after the EOF. 

Permanent file mode for sample data file. 

Default is M = WRITE. 

xxxx can have one of the following values. 



Value 



Description 



WRITE or W Sample file attached in write mode. 
APPEND or A Sample file attached in append mode. 
MODIFY or M Sample file attached in modify mode. 



NOTE 



If the sample data file is attached in write mode, 
the file cannot be accessed until ENDCPD is run. 
If the sample data file is to be accessed while 
data is being collected, append or modify mode 
must be specified. In this situation, the file may 
be attached in read/allow modify (RM) mode. 
(Attaching the file in write mode rather than in 
modify or append mode has the advantage of 
expending less overhead when interlocking and 
writing the data file.) 

If a loop time is set to zero, no samples for that 
loop will be taken. 

All numeric data should lie within the range 
through 4095D (0 through 7777B). 
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ACPD Control Statement 

ACPD reads the data file produced by CPD and generates a summary of the data for further analysis. 
The data file must be attached before ACPD is called. If ICPD is caUed with the M parameter, the data 
file may be accessed while CPD is still active. 

Control statement format: 
ACPD( Pl ,p 2 ,..., Pn ) 

Pi Description 



FN=lf ni 
L=lfn 2 
S=lfn 3 
IN=nnn 

LO=Z 
N=nnnn 



Name of sample data file. 
Default is SAMPLE. 

Output file name. 
Default is OUTPUT. 

Summary file name. 
Default is SUMMARY. 

Length of time of summary interval, in minutes. 

Default value is 2 minutes. 

ACPD will output a report for each summary interval. 

List zero data items (having value of zero). 
Default is not to list zero data items. 

Number of files to process. 

Default is only one file processed. 

If N or N=0 is specified, all files are processed to EOI. 



ENDCPD Control Statement 

The ENDCPD control statement terminates all active copies of CPD. 

Control statement format: 

ENDCPD. 
Figure 15-1 shows sample data summaries produced by TRACER. 
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Figure 15-1. Example of TRACER Output (Sheet 1 of 12) 



A C F D - VER 7. 00 €0/09/17. lf.S9.24. 

135) CYBER 170-76C/420. NCS CISH. NOS 1-2G03T/R7B. 



V EQUIPHFKT STATUS TABLE ^*V^ .x-Cl) 

OJ KC. TYPE SIAT CP EC UN CHANNELS EST ENTRY TRACK CAP. FILES 

4> 



1 Dl PF / 21 20 62002C21000C04141002 31J0 XT— r— — 

2 CI CK (u) 20 21 62CC2120000Q04141C7C 31S0 XT — ~ 

3 CI CK ^ 21 20 42C020210000041U156 31*0 -T— — — 

« CK CK 20 21 42C0212O00O0O4131243 3140 -T 

f CI CK 22 23 42CC23220000041H33C 3140 -T 

6 OC CN 5 7 42000705000004211415 3222 — 

7 DC CK 7 : 42C0C5070O00042115O4 3222 

ID CS CK 7 1C 000000100001,04237000 

11 U CK 22 £3 46002322o000041U573 3140 

12 TC CK s 7 4200070500000421166C 3222 — — 

13 rc CK 7 5 420005O7O0O004211747 3222 

14 CC CN 5 7 4200C705000004212C36 3222 

1* CC CK 7 5 4200CS07000C04212125 3222 

U CI CK 22 23 46002322000004112214 3140 

17 CJ CK 23 22 4700«.?23000CO4122301 3150 

2C DJ CK 2? 23 47002322000004122367 3150 

21 Ci QK ?3 22 4700222300004122455 3150 ~ 

22 TJ CK 21 20 47002021000004122543 3150 

23 DJ CK 5 7 4701C705000004122631 3150 

2* CJ PN 22 2* 47002j2<:000004122717 3150 

2^ CJ CK 7 5 47000SO7OOG004123005 3150 

tt CJ CK 5 7 4700C7OiOO00O41230J3 3150 — — — 

27 CJ LK 20 21 46002120000004113161 3140 

30 DI CN 2i 23 47002322000004113246 3141 

»1 CI CK 23 22 4?ufl2223OO0l3O4113333 3140 — 

32 CI CK 21 20 4700202100000411342C 3140 

33 PI CK ?2 23 47CO?3220O0uO4113505 3140 

?4 CI CK 2U 21 47002120000004113572 3140 

" CI LK 23 2i 470C2223OO00O4113657 3140 

3f CJ CK 22 23 47002522000004113744 3140 

37 CI CK 23 22 47002223000004114031 3140 

*C CP CN 4 12 00000012000003224000 

41 CF CK 7 12 00000012C0000320700C 

«2 KP CK 7 11 00000001000216207001 

4" KF CK 7 16 O00CC006CO0516207001 

46 Sf CK 7 0? COC00CO20000230570OC 

JO K'T PK C 13 3i CCCC321300001624040C 

r l PI CK 1 13 32 00003213000015240401 

52 *T CK 2 13 32 00003*13000015240402 

i3 M CK 3 13 32 00Q032130OO01>24O403 

:4 PI CK 4 13 32 00003213000Cli>240404 

S5 CS CK 6 27 000000*7440003230106 

^6 CI CK 27 C000002744000324000C 

J7 CT CK C 2 27 00000027440203240^02 

*C K-T C« 4 20 31 33 OOOV.3331000C1624422C 

a KI CK 4 21 31 33 00003331000016244221 

62 KT CK 4 2? 31 33 00003331000016244222 

63 KI CK 4 23 Jl 33 00003331000016244223 

64 M CN 4 4 31 33 00003331000016244204 

65 KI CK 4 i 31 33 C00C333IO0OC162442O5 

66 M Ch 4 6 31 33 00C033310OO01S2442O6 

67 PI CK 4 7 3! 33 00003331000015244207 
7C IT CK 23 1 C 12 00230012000014241000 



L 



L 



THIS PAGE REFLECTS THE STATUS OF THE EST AT 
THE BEGINNING OF THE SAMPLING INTERVAL 



— ON/OFF STATUS \^^^ 

EQUIPMENT TYPE ^^ OCTAL REPRESENTATION OF THE EST ENTRY 



EST ORDINAL 

A C P D - VEP 7.CC PO/09/17. 18. , !<J.24. PA6E 3 

(35) CYBER 170-76P/420. NOS CtSH. NCS 1-2G03T/»7B. 

71 IT CN 3 12 O0C0OO12O0O0142430OC 

72 IP CN 2 12 0000001200001420260C 

73 LT OK 5 12 00C00O1200O0142456OC 
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75 TT CN 2 20000000010224240002 

Oj 76 TE CK 20000COOOOOC24050COC 

O 77 NE c * COO 20000000000C16C5000C 
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Figure 15-1. Example of TRACER Output (Sheet 2 of 12) 
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NCS 1-2603T/R7B. 



PAGE 



SYSTPA CtMROL IMURPATICN 



JOP 
TTPF 


CLILf 


PPICPttlfS 
CP LP OP IN PR/NJ 


SERVICE 
CP/fL 


LIMITS 
CM/AN 


itCT 


IK 
PC 
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7757 

fcCCC 
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30C0 1 
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20 
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efCT 


PC 
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24CC 


2CC0 

ioic 

ICC 


4C1Q 

40C4 J 

70C0 ] 


1 ac 
L 7777 


4C0 
7777 


200 
7777 


FICT 


IK 
PC 

n 


34CC 
34CC 

2CC 


24CC 
1100 

ICC 


4010 

4006 i 

7C00 


L 30 
7777 


400 
7777 


200 
7777 


TXCT 


IN 
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4wOC 

4004 
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377C 

3740 
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THIS PAGE REFLECTS THE STATUS OP THE JOB CONTROL AREA 
AT THE BEGINNING OF THE SAMPLING INTERVAL. THESE VALUES 
ARE SET BY THE QUEUE AND SERVICE IPRDECK AND DSD COMMANDS. 



Figure 15-1. Example of TRACER Output (Sheet 3 of 12) 
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A C f D - VEP 7.0C 

(35) CYBER 170-76C/42C. NOS CISh. 



80/09/17. IB. 59. 24. PA6E 
NOS 1-2G03T/R7B. 



DATE 60/09/17. 



CURRFNT TIM 06.07.26. 



eLAPScC TIPE tO hIN. 



STARTING BLOCK 



ENDING BUCK 



720 



VARIABLF 



FAST ICCP VARIABLES 



/PPUS ACTTV^ 




/ l«CVE REfitF'T Pt^I! 


f\ NC PPL 


AVAllABLi 


t 


2/ *TR CYCLF Tlfr 




PLhTTOP 


NODE - 1 


CPU 


SCI-FOUtR AfTIVl 


CMNNFL 


fctSFfcvrr 




CI- 


1 




Cl- 


? 




CH 


c 




Cl- 


e 




c^ 


7 




CK 


1C 




Ch 


12 




ct- 


11 




c+ 


1* 




Ch 


i; 




c»- 


16 




ct- 


2C 




Ch 


21 




Ch 


22 




CH 


23 




Cf 


27 




Cl- 


31 




C»- 


3? 




CH 


43 


CMNNFL 


ACTIVE 






CH 


1 




CI- 


2 




Ch 


s 




Ch 


6 




CH 


7 




CH 


10 




ri- 


12 




ch 


13 




CH 


16 




CK 


20 




CI- 


21 




Cl- 


22 




Cl- 


23 




Cl- 


27 




Ch 


31 




CI- 


3? 




CI- 


33 



sT. 



INTERVAL 
AVFRAGE STC DEV PERCENT 



INTERVAL SAMPLES 680576 



7 


2.19fc 


36.866 





0.045 


1.431 





COCA 


O.Ctl 





0.146 


0.224 





0.014 


5.767 





C.0a7 


5.407 





C.G5f 


49.069 


c 


0.15C 


97.622 





0.17i 


10.55b 





O.Osi 


49.172 





0.111 


4.269 


1 


O.OuO 


IOC. CCO 





0.494 


56.1S7 


c 


t.Obl 


1.065 





C.009 


0.639 





o.oc? 


0.652 


c 


0.003 


0.014 





0.289 


36.4C4 


c 


0.292 


31.342 


c 


C.07fe 


1.350 


c 


C.?^l 


17.360 


D 


0.001 


0.003 





0.157 


3.163 


u 


0.004 


0.167 





C.C1C 


0.227 


c 


O.^oo 


3.274 


C 


0.01C 


5.766 





0.131 


b.0<:2 


c 


0.MO7 


2. 605 


c 


0.083 


3. £42 


p 


0.192 


72.610 


c 


C.ObS 


8. 836 


c 


0.070 


0.7bl 


1 


C.OOC 


100. COC 





0.229 


29.240 





0.230 


24.665 





0.066 


1.134 





0.183 


14.490 


C 


O.OCC 


0.0C1 


c 


0.153 


2.892 


C 


0.002 


U.1C5 


c 


0.009 


0.102 





C U M U 


L A T I V 
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AVfcRAGE 


STO DEV 


PERCENT 


KIN PCT 


MAX PCT 


{ 


TOTAL 


SAMPLES 


680576 




/ 

7 


2.196 


36.886 


36.886 


36.886 





0.045 


1.431 


1.431 


1.431 





0.004 


0.051 


0.051 


0.051 





0.146 
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C.224 





0.014 


5.767 
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36.404 
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0.221 
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0.004 


0.187 
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0.010 
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Figure 15-1. Example of TRACER Output (Sheet 4 of 12) 
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80/09/17. 18.59.24. 
NOS 1-2G03T/R78. 



0*11 ec/09/17. 



CURREM tlH 08. 07.28, 



PAGE 6 
ELAPSED TIME 60 KIN. 



STARTING BLOCK 



ENDING BLOCK 



720 



variable 




cmnnu rpoxfsi*c 




CK ! 




7 




a 1C 




CI- 12 




CI- 14 




Ch IE 




C»- 20 




CI- 21 




CH 22 




CI- 23 




RffcLfcSTS PfUCTKC 




FC 1 




EC 2 




rc 3 




EC 4 




RC S 




tc ft 




FC 7 




EC 11 




FC 12 




FC 13 




EC 14 




EC 15 




EC 16 




FC 17 




rc ac- 




EC 21 




EC 22 




EC 23 




EC 24 




EC 25 




LC 26 




EC 27 




EC 3C 




tC 31 




EC 3? 




EC 33 




EO 34 




EC 35 




rc ae 




EC 37 




PF* ACTIVITY 




PFH - 


1 


FF* - 


2 


fff - 


3 


PFP - 


4 



AVERAGE 



N T E R V A L 

StU DEV PFRCEMT 



0.017 


C.266 


0.011 


0.172 


0.051 


0.321 


0.009 


0.164 


O.QOO 


0.005 


0.000 


C.OOG 


0.207 


13.737 
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0.049 
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0.271 
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0.003 


0.014 


0.001 
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0.007 


0.121 


6.021 
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0.002 
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HIN PCT 


MAX PCT 


0.017 
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Figure 15-1. Example of TRACER Output (Sheet 5 of 12) 
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VARIABLE 



rpt USAC* - CPl C 
It 1 1 
iYJTEf 
SIF-iYS 
iY5 CRG 
ISFft 
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PXFS-»1 
PSS 
PC 5 

ppr 

kap 

STiPULA 

pacmt 

1AF 

IttCUt! LCCP VAPI ABIFS 

CPS IK V STATUS 
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Fin 

TXCT 
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PCCT 
UCT 
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SYET 
BfCT 
EICT 
TXCT 



CURREM TIPfc 06.07.28. 



ELAPSED TIKE 60 PIN. 



AVFBAGE 



N T E R V A L 

STO DEW PERCENT 






C.013 


0.159 





0.007 


C.357 





0.017 


6.959 





0.290 


73.35c 





0.29P 


17.126 


c 


0.01C 


1.633 





C.005 


0.761 


f! 


G.0C4 


0.644 





G.002 


0.279 





C.C05 


1.122 





0.000 


0.005 





C.007 


1.371 





0.004 


1.295 


ft 


0.005 


1.669 


INTfcKVAL samples 


359ei 


6 


0.745 


30.763 


8 


C.996 


«2.031 


c 


0.634i 


2.461 


113 


23.093 


23.722 





0.007 


0.136 


3335B 


596. *9 3 


49.539 


15 


1.097 


75.fcf5 


U 


1.216 


2.399 


c 


C.404 


0.412 





0.907 


3.1E6 


2665B 


219.037 


41.196 


217B 


400.937 


4.C33 


26P 


116.700 


0.64b 


264B 


344. oil 


5.wbC 


OP 


C.086 


c.cco 


OB 


0.11! 


0.001 


wB 


0.204 


C.C01 


31P 


76.203 


0.722 


36 


29.923 


0.1C3 


OB 


12.112 


0.017 


21* 


104.877 


0.494 



IN. S 


FARTING BL 


DCK 1 


ENDING 


BLOCK 




C M U 


L A T I V 


E 




AVeRAGE 


STO DEV 


PERCENT 


HIN PCT 


MAX PCT 





0.013 


0.159 


0.159 


0.159 





0.007 


0.357 


0.357 


0.357 





0.017 


8.999 


8.999 


8.999 





0.290 


73.358 


73.358 


73.358 





0.290 


17.126 


17.126 


17.126 





0.010 


1.633 


1.633 


1.633 





G.005 


0.781 


0.781 


0.781 





0.004 


0.644 


0.644 


0.644 





0.002 


0.279 


0.279 


0.279 





0.005 


1.122 


1.122 


1.122 





0.000 


0.005 


0.005 


0.005 





C.007 


1.571 


1.571 


1.571 





0.004 


1.295 


1.295 


1.295 





0.005 


1.669 


1.669 


1.669 




TCTAl 


SAMPLES 


35981 




6 


0.745 


30.763 


30.763 


30.763 


a 


0.996 


42.031 


42.031 


42.031 





0.634 


2.461 


2.461 


2,461 


J.13 


23.093 


23.722 


23.722 


23.722 





0.007 


0.136 


0.136 


0.136 


333?6 


596.295 


49.539 


49.539 


49.539 


15 


1.097 


75.865 


75.885 


75.885 





1.216 


2.399 


2.399 


2.399 





0.404 


0.412 


0.412 


0.412 





J. 907 


3.186 


3.186 


3.186 


2665E 


219.637 


41.196 


41.196 


41.196 


2176 


400.937 


4.033 


4.033 


4.C33 


26B 


116.700 


0.646 


0.646 


0.646 


2648 


344.835 


5.0B0 


5.080 


5.080 


oe 


0.068 


0.000 


0.000 


0.000 


06 


0.115 


0.001 


0.001 


0.001 


OP 


0.204 


0.001 


0.001 


0.001 


3ie 


76.203 


0.722 


0.722 


0.722 


3B 


29.923 


0.103 


0.103 
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OB 


12.112 


0.017 


0.017 
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0.494 


0.494 
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Figure 15-1. Example of TRACER Output (Sheet 6 of 12) 



A C P D - VER 7. CO 

<35J CYBER 170-76C/420. *CS CLSH. 



80/09/17. ie. 59.24. PAGE 
NOS WGU3T/R7B. 



en 

CO 

oo 



Q 



)ATfc 80/09/17. 


CtRR 


VARIABLE 




51BSVSTFK FL 






*XFS 




K>PS4l 




K?i 




^?^' 




*cs 




Rfif 




NAr 




STIKLA 




TAF 




CAC-NFT 




EATCHO 




TAf 


SICK LCCP VARIABLES 


I*F USPS 




TAF POTS ALLCCATFF 


TAP POT? IN 


L?F 


TAPf CR1VES 


H IS* - 




7 IRaCK 




<5 TfcACK 


TRACKS AVAILABLE 




FC 1 




re 2 




FC 3 




EC 4 




fc ; 




fcC 6 




re ? 




ec n 




FC 12 




EC 12 




re 14 




FC 1! 




ec ie 




FC 17 




FC 2C 




FC 21 




tC 22 




FC 23 




FC 2« 




ec 22 




ec 26 




FC ?7 




EC 3C 




EC 31 




EC 32 




EC 32 




EC 34 




EC 35 



CURRENT TIPE 08.07.2b. 



ELAPSED TIKE 66 KIN. 



STARTING BLOCK 



ENDING BLCCK 



720 



i N 


T E R V A 


L 


AVERAGE 


STC OFV 


PERCENT 


3B 


16.901 


0.105 


3sse 


36.742 


6.690 


14B 


13.991 


0.349 


OB 


1.442 


0.0C7 


246 


2C.979 


0.579 


217B 


49.2S4 


4.054 


15EB 


14.2a? 


3.083 


2B 


20.623 


0.CJ9 


366B 


172. to3 


6.947 


23B 


O.uOO 


C.S36 


22B 


19.327 


0.516 


2366 


6.64c 


4.4*8 


INTERVAL SAMPLES 


3599 


ti 


7.17C 


12.791 


7<5 


9.013 


75.176 


19 


5.069 


26.141 


OB 


0.125 


0.1?6 


OB 


0.395 


1.509 


2452B 


30.302 


86.617 


24546 


25.641 


80.754 


2756B 


61.782 


93.059 


2eaeB 


ae.t09 


86.119 


?644B 


99.367 


88.529 


1670B 


0.256 


56.603 


1136B 


0.269 


36.084 


31CB 


C.CS.7 


12.255 


IfOtP 


C.107 


53.627 


112B 


0.93C 


4.415 


147B 


U.205 


6.126 


1S35B 


c.ooo 


51.189 


120B 


0.000 


4.9C2 


315C8 


c.ooc 


IOC. 000 


3150B 


0.000 


100.000 


3150B 


C.OuC 


100.000 


315CB 


C.000 


100.000 


2261B 


663.887 


73.290 


2414B 


216.604 


78.781 


704B 


699.611 


27.595 


1261B 


560.127 


42.031 


!>14B 


O.OOC 


20.343 


3140E 


0.000 


100,000 


3140B 


O.ObO 


10C.0G0 


3140B 


0.000 


100. oco 


314QB 


0.000 


100.000 


2760B 


344.013 


93.173 


?616£ 


335.643 


87.150 



AVERAGE 


STO OEV 


PERCENT 


HIN PCT 


MAX PCT 


3B 


16.901 


0.105 


0.105 


0.105 


355E 


36.742 


6.690 


6.690 


6.690 


14B 


13.991 


0.349 


0.349 


0.349 


OB 


1.442 


0.007 


0.007 


0.007 


246 


20.979 


0.579 


0.579 


0.579 


217B 


49.294 


4.054 


4.054 


4.054 


155B 


14.212 


3.083 


3.083 


3.083 


26 


20.623 


0.059 


0.059 


0.059 


366B 


172.653 


6.947 


6.947 


6.947 


231? 


0.000 


0.536 


0.536 


0.536 


22B 


19.327 


C.516 


0.516 


0.516 


2366 


5.646 


4.458 


4.458 


4.458 




TCTAL 


SAMPLES 


3599 




8 


7.170 


12.791 


12.791 


12.791 


75 


9.013 


75.176 


75.176 


75.176 


19 


5.089 


26.141 


26.141 


26.141 


6 


0.125 


0.128 


0.128 


0.128 


08 


0.395 


1.309 


1.509 


1.509 


24526 


30.302 


80.627 


80.627 


80.627 


24546 


25.641 


80.754 


80.754 


80.754 


2756B 


61.782 


93.059 


93.059 


93.059 


2636B 


88.609 


88.119 


86.119 


88.119 


26446 


99.367 


88.529 


88.529 


88.529 


1670B 


0.256 


56.603 


56.603 


56.603 


1136B 


0.269 


36.084 


36.084 


36.084 


3106 


0.097 


12.255 


12.255 


12.255 


16066 


0.107 


53.627 


53.627 


53.627 


112B 


0.930 


4.415 


4.415 


4.415 


1476 


0.205 


6.126 


6.126 


6.126 


15356 


C.000 


51.189 


51.189 


51.189 


1206 


0.000 


4.902 


4.902 


4.902 


31508 


C.000 


100.000 


100.000 


100.000 


31506 


0.000 


100.000 


100. 000 


100.000 


3150B 


0.000 


100.000 


100.000 


100.000 


31506 


0.000 


100.000 


100.000 


100. oqo 


2261B 


663.887 


73.290 


73.290 


73.290 


2414B 


216.604 


78.781 


78.781 


78.781 


704B 


699.611 


27.595 


27.595 


27.595 


12616 


560.127 


42.031 


42.031 


42.031 


514B 


0.000 


20.343 


20.343 


20.343 


3140B 


0.000 


100.000 


100.000 


100. COO 


31401? 


0.000 


100.000 


100.000 


100. COO 


31406 


0.000 


100.000 


100.000 


100. 000 


31406 


0.000 


100.000 


ICQ. 000 


100.000 


27600 


344.013 


93.173 


93.173 


93.173 


26166 


335.843 


87.150 


87.150 


87.150 
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<3!) CYBER 170-76C/<20. NCS CLSM. 



80/09/17. 18.59. 24. PAGE 
NCS 1-2603T/R7B. 



D«Tf 80/09/17. 



CURRENT TIKE 08.07.28. 



ELAPSfcO TIME 60 KIN. 



STARTING BLOCK 



ENDING BLCCK 



720 



VARIABLE 



INTERVAL 
AVERA6F STO OEV PERCENT 



EC 36 
FC 27 



26418 
27C5B 



SNAP SHCT OF INSl 



(C) • occooocoocooccoooooc 

(1) - occcooccccocccoooooc 

(?) - C0CCOOCCCCOCP00COO0C 

(3) ■ CCCOOOCOflCCOCtOCOOOC 

(4) ■ OCCOOOCOOOOOOCOOOOOO 

(5) - occcoooooooocococooc 

it) - OCCOflOdOOCOOCOOCOCOO 

(7) - CCCCOCCOCCCOfCOOOCOO 



SNAP SHCT OF SCAt 

(0) - 0CCCOOCO0612CCC3OCOO 

(1) • CCCC0OCOCC0QCCO11334 

(2) - 00CC44f3C000CU6tl55 

(3) - CCCOOCCOC0010COOC256 

(4) - CCCOOCCOCCOCCCOOOOgC 

(5) - 4CCCOO0O0536CC10356C 
(t) - OOCOOOOOCCCCOCOOOOOO 
(7) - CCCOOOOOCCCOCCOOOOOC 

SNAP SHOT CF MP 

(0) • 1SZ422C1CC0CCC0OO0OC 
SM*» SHOT CF CPTk - CFQ 

(C) - CCC0OOiei56303767OOC 
SNAP SHCT OF CFU - CPN 

<*> - CCCC00CCtl3211243«0C 
SNAP SFCT CF PTCl 

(0) ■ 00eC74t3CCC01fc6!>7471 
SNAP SHOT OF 7]fl 

<0> - £533435?3342S7354i57 



118.502 
96.057 



88.335 
90.544 



AVERAGE 


STD OEV 


L A T I V E 
PERCENT HIN PCT 


MAX PCT 


26418 
27058 


116.502 
96.057 


88.335 88.335 
90.544 90.544 


88.335 

90.544 



■INSTALLATION AREA FROM LOW CORE 



MTP MXN TIME - 
NUMBER CF ECS MOVES - 
NUMBER OF ROLLOUTS - 
RGLLCUTS/USEP LIMITS > 
PP PRIORITY EXCHANGES 



394 



2355 

1 





WORST CASE HTR CYCLE TIME - 3 

NUMBER OF CM MOVES - 4828 

NUMBER OF SECTORS RCLLEO - 322669 

NUMBER OF TIME SLICES - 174 



'STATISTICAL DATA AREA FROM LOW CORE 
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©The following symbols are assembly constants that are used in NOS. 

CTCUL Categories of CPU use. 

CTILL Length of channel status table. 

MXOT Maximum number of origin types. 

MXPS Maximum priority for rollout. 

NMSD Maximum EST ordinal + 1 of mass storage devices. 

NPFS Number of PFMs active simultaneously. 

QUFT Maximum number of queue file types. 

MXRS Maximum number of RTCM subfunction device types. 



©The equipment status table (EST) entry consists of the octal representation of the EST entry at the start of the sampling interval. 



©FILES indicates what type of file can reside on a given device. File assignment is controlled largely by the MSAL and TEMP 
commands. The following list indicates the type of file assigned to a particular 1 device. 



Letter 



File Type 



Letter 



File Type 



B 


LGO 


P 


Primary 


D 

I 

L 




Dayfile 
Input 
Local 
Output 


R 
S 
T 


Rollout 

Secondary rollout 
Temporary 



© Interval statistics refers to only a portion of the entire sampling interval. The interval time (the number of minutes that make up 
an interval) is specified by the IN ACPD control statement parameter. 
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The column labeled AVERAGE is computed with the following formula: 
AVERAGE = INT (count/samples) 
INT(x) The integer function. 

count The number of times the variable was in a given state during the sampling interval. This data is not reported, 

samples The number of samples taken during the interval. 

For example, the number of PPs active for an interval is 55 696. The total number of samples taken is 10 988. Applying the 

AVERAGE = INT (55696/10988) 
= INT (5.06) 
= 5 

Therefore, an average of five PPs were active at any one time during the sampling interval. 

The column labeled STD DEV is computed with the following formula: 



Standard deviation 



yf 



X 



count * count 
samples 



samples -1 



N 

2 

i = 1 



coun ty * count; 



N 

count 

samples 



samples j 
The number of samples. 

The number of times the variable was in a given state during the specified time interval. 
The number of samples taken during the interval. 



The column labeled PERCENT is computed with the following formula: 



PERCENT 

count 

samples 

wfactor 



count 



x 100 



samples x wfactor 

The number of times the variable was in a given state during the specified time interval. 

The number of samples taken during the interval. 

Weight factor. This value is dependent on the variable, and might be set to 1, 100, the number of PPs, the 
number of CPUs, and so on. Refer to table 15-1 for further information. 
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Continuing with the previous example, the percentage of PPs active can be determined in the following way (wfactor = 20): 

PERCENT = 55696 x 100 = 25.344% 

10988 x 20 

©Cumulative statistics is a summation of all data gathered from the beginning of the sampling interval up to the current interval. 

The column labeled AVERAGE is computed with the following formula: 

AVERGE = INT (count/samples) 

INT(x) The integer function. 

count The number of times the variable was in a given state since the beginning of the sampling period. 

samples The number of samples taken since the beginning of the sampling period. 

For example, the total number of PPs active during the sampling interval up to this point is 3 729 736. The total number of 
samples taken is 366 076. Therefore, the average number of active PPs can be determined: 



AVERAGE = 



INT (3729736/366076) 

INT (10.18) 

10 



The column labeled STD DEV is computed with the following formula: 
Standard deviation = 1 y 



X 



count * count 



samples 
samples -1 



X 



N 

2 

i = 1 



coun tj * countj 



samples j 

N The number of samples. 

count The number of times the variable was in a given state since the beginning of the sampling interval. 

samples The number of samples taken since the beginning of the sampling interval. 

The column labeled PERCENT is computed with the following formula: 

PERCENT = count x 100 

samples x wfactor 
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The percentage of PPs active can be calculated in the following way (wf actor = 20): 

PERCENT = 3729736 100 

366076 x 20 

50.94% 

This means that a given PP is active for about half the samples taken. 

The column labeled MIN PCT shows the minimum interval percentage that has been encountered since the beginning of th* 
sampling period. » & 

The column labeled MAX PCT shows the maximum interval percentage that has been encountered since the beginning of the 
sampling period. 

©The sampling frequency for fast loop variables is specified by the FL parameter on the ICPD control statement. Typically, the 
fast loop variables are continuously changing, so they should be sampled very frequently. (Fast loop variables are discussed later 
in this section.) 

©Interval samples are the number of samples taken during the specified time interval only. 

© Total samples are the number of samples taken since the beginning of the sampling period. 

® The sampling frequency for medium loop variables is specified by the ML parameter on the ICPD control statement. (Medium loop 
variables are discussed later in this section.) 

©The sampling frequency for slow loop variables is specified by the SL parameter on the ICPD control statement. (Slow loop 
variables are discussed later in this section.) 

@ The equipment and unit numbers for mass storage devices are not present on reports. 
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SAMPLED SYSTEM VARIABLES 

The system variables sampled by TRACER are described in the following paragraphs and are summarized 
in table 15-1. TRACER increments each variable's counter when the variable is in a given state, and 
periodically writes the counters to the data file for future processing by ACPD. When and how the 
counter for a given variable is incremented is also discussed. 

TABLE 15-1. WEIGHTING FACTORS 



Fast Loop Variable 


Weighting Factor 


PPs active 

Move request pending 
No PP available 
ECS transfer in prog 
MTR cycle time 
Monitor mode 
Scheduler active 
Channel reserved 
Channel active 
Channel requested 

T3o/-iiuv<st npnrlincr 

PFM activity 
CPU usage 
Subsystem CPU usage 


Number of PPs available 
it 
1 

1 
100 

1 
1 

1 
1 
1 
100 

1 
1 
1 


Medium Loop Variable 


Weighting Factor 


Control points in W status 
Control points in X status 
Control points in I status 
Non-queue files 
Same move request 
FL available 

User ECS available 
Control points active 
FL at control points 
User ECS at control points 
FL in input queue 
FL in rollout queue 
ECS in rollout queue 
Subsystem FL 


Number of control points 

Number of control points 

Number of control points 

Number of FNT entries 

it 

Available field length 

(machine size - CMR size) 
Available user ECS field length 
Number of control points 
Available field length 
Available user ECS field length 
Available field length 
Available field length 
Available field length 
Available field length 


Slow Loop Variable 


Weighting Factor 


IAF users 
IAF pots in use 

IAF pots allocated 
Tape drives in use 
Tracks available 


Number of terminals defined 
Percentage of IAF pots in use as 

a function of IAF pots allocated 
lOOtt 

Number of available tape drives 
Maximum number of tracks for 

monitored device 


t A weighting factor of 1 means that the value printed in the Percent columns represents 
percentage of time. 
TtA weighting factor of 100 means the value printed in the Percent columns represents the 
actual value of the variable. 
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Fast Loop Variables 

The following paragraphs describe fast loop variables. 

PPs Active 

TRACER increments the PP active counter for each active PP it finds when scanning the PP 
communication area. Disabled PPs (those turned off at deadstart time) are not considered active. An 
active PP is one that has a nonzero input register. MTR (PPO) and DSD (PP1) are always counted as 
active PPs. 

Move Request Pending 

TRACER increments the move request pending counter whenever it determines, from word CMLL of low 
central memory, that a storage move request is outstanding. 

No PP Available 

TRACER increments the no PP available counter each time it determines, from word PPAL of low 
central memory, that there are no PPs available. 

ECS Transfer in Progress 

TRACER increments the ECS transfer in progress counter whenever the status and control register (SCR) 
indicates an ECS transfer is active. This data is available for CYBER 170 Series only. 

MTR Cycle Time 

TRACER increments the MTR cycle time counter by the cycle time for the last MTR cycle reported in 
MTR's input register. This variable indicates how fast MTR is completing one complete scan of all PP 
output registers and processing those functions present. 

Monitor Mode - CPUO 

TRACER increments the monitor mode counter for CPUO whenever the SCR register indicates the CPUO 
is in monitor mode. This data is available for CYBER 170 Series only. 

Monitor Mode - CPU1 

TRACER increments the monitor mode counter for CPU1 whenever the SCR register indicates that 
CPU1 is in monitor mode. This data is available for CYBER 170 Series only. 
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Scheduler Active 

TRACER increments the scheduler active counter whenever it determines that the job scheduler (1SJ) is 
active. The job scheduler is considered active when the scheduler active flag in word JSCL + 1 is set. 

Channel Reserved 

TRACER maintains a channel reserved counter for each available channel and increments one whenever 
its channel is logically reserved by the operating system. TRACER samples the channel status table 
(CTIL) for this data. 

Channel Active 

TRACER maintains a channel active counter for each available channel and increments a counter 
whenever it detects that the channel is not inactive, as determined by an IJM PP instruction. 

Channel Requested 

TRACER maintains a channel requested counter for each available channel, and increments a counter 
whenever there is an outstanding request for that channel. TRACER uses the channel status table (CTIL) 
to determine the channel requested status. 

Reauests Pendiner 



TRACER maintains a request pending counter for each mass storage device available and increments a 
counter by the number of outstanding requests on that device when the sampling occurs. The mass 
storage table (MST) provides this information. 

PFM Activity 

TRACER maintains counters for the number of permanent file managers (PFM) that are active at the 
time of the sampling. Word PFNL of CMR determines this information. 

CPU Usage 

TRACER maintains a set of CPU usage counters for each CPU. There is a counter for each type of CPU 
use. 

IDLE CPU is not currently being used. 

SYSTEM CPU is being used by CPUMTR. 

SUB-SYS CPU is being used by a subsystem. 

SYS ORG CPU is being used by a system origin job (subsystems are not considered system 

origin). 

USER CPU is being used by a user program. 
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Each time the CPU status is sampled (in words ACPL and ACPL + 1 in low central memory), TRACER 
increments one of the CPU usage counters. It determines which counter to update by investigating the 
control point area to which the CPU is assigned. vwiigaung me 

Subsystem CPU Usage 

Subsystem CPU usage is a further breakdown of subsystems of the SUB-SYS CPU usage data. TRACER 
maintains a CPU usage counter for every subsystem. Whenever the SUB-SYS CPU usage counter is 
incremented, TRACER also increments the appropriate subsystem CPU usage counter. 

Medium Loop Variables 

The following paragraphs describe medium loop variables. 

CPS in W Status 



TRACER increments the control points in waiting (W) status counter whenever a control point is found in 
W status (determined by STSW word of control point area). TRACER scans all control points during each 
medium loop cycle. % 

CPS in X Status 

TRACER increments the control points in executing (X) status counter whenever it finds a control point 
in X status (determined by STSW word of control point area). TRACER scans all control points during 
each medium loop cycle. B 

CPS in I Status 

TRACER increments the control points in inactive (I) status counter whenever a control point is found in 
I status (determined by STSW word of control point area). TRACER scans all control points during each 
medium loop cycle. * 

Non-Queue Files 

25£™ increments the non-queue file counter for every file found assigned to a control point. 
TRACER scans the entire FNT during each medium loop cycle. 

Same Move Request 



TRACER increments the same move request counter every time the move request pending for the 
current medium loop sample is the same as the previous medium loop sample. Word CMCL of low central 
memory is used to determine this status. UIU 



FL Available 



iSo ovHP^wLTArJ? 6 ,^ ^f^ counter b J } he ? mount of available FL during the current medium 
loop cycle. Word ACML of low central memory determines the available FL. 



User ECS Available 



TRACER increments the user ECS available counter by the amount of available user ECS FL during the 
current medium loop cycle. Word AECL of low central memory determines the available user ECS FL? 



1 5-20 

60455380 G 



CNTL Points Active 

TRACER increments the control points active counter for every control point that is currently assigned 
to a job or subsystem. A control point is considered to be assigned to a job if a job input file FST address 
is set in TFSW of the control point area. TRACER scans all control points during the medium loop cycle. 

FL at Control Points 



TRACER maintains an FL at control point counter for each origin type. When an active control point is 
found, the origin type is determined, and the appropriate counter is incremented by the amount of FL 
assigned to that control point (determined by STSW of control point area). TRACER scans all control 
points during the medium loop cycle. 

UECS at Control Points 



TRACER maintains a user ECS at control point counter for each origin type. When an active control 
point is found, the origin type is determined, and the appropriate counter is incremented by the amount 
of user ECS assigned to that control point (determined by ECSW of control point area). TRACER scans 
all control points during the medium loop cycle, 

FL in Input Queue 

TRACER maintains an FL in input queue counter for each origin type. When an input file is found not 
assigned to a control point, the amount of FL it will require when rolled into a control point is added to 
the appropriate counter. The amount of FL is determined by examining the FST. TRACER scans all 
FNTs during the medium loop cycle. 

FL in Rollout Queue 



TRACER maintains an FL in rollout queue counter for each origin type. When a rollout file is found in 
the queue, and it is not assigned to a control point, the amount of FL it will require (determined from the 
FST) when it is rolled into a control point is added to the appropriate counter. TRACER scans all FNT 
entries during the medium loop cycle. 

ECS in Rollout Queue 



TRACER maintains an ECS in rollout queue counter for each origin type. When a rollout file is found in 
the queue, and it is not assigned to a control point, the amount of ECS FL it will require when rolled in 
(determined from the FST) is added to the appropriate counter. TRACER scans all FNT entries during the 
medium loop. 

Subsystem FL 



TRACER maintains a subsystem FL counter for every possible subsystem. When a subsystem is found at 
a control point, the amount of FL assigned to that subsystem is added to the appropriate counter. 
TRACER scans all control points looking for subsystems during the medium loop. 
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Slow Loop Variables 

The following paragraphs describe slow loop variables. 

IAF Users 



TRACER increments the IAF users counter by the number of users connected to IAF during the slow loop 
cycle. TRACER does not differentiate between IAF and TELEX. IAF or TELEX must be active for this 
data to be collected. Word VANL of IAF/TELEX FL determines the number of users. 

IAF Pots Allocated 



TRACER increments the pots allocated counter by the number of pots that are currently available for 
use, whether they are being used or not. TRACER does not differentiate between IAF and TELEX. Word 
VPAL of IAF FL determines the number of pots allocated. 

IAF Pots in Use 



TRACER increments the pots in use counter by the number of pots currently assigned to a connection. 
TRACER does not differentiate between TELEX and IAF. Word VPUL of IAF FL determines the number 
of pots in use. 

Tape Drives in Use 



TRACER maintains two tape drives in use counters; one for seven-track and one for nine-track drives. A 
tape drive is considered to be in use if an EST entry indicates it is logically turned on, and it is assigned 
to a control point. TRACER increments the appropriate counter for each drive found in use. 

Tracks Available 



TRACER maintains a tracks available counter for each mass storage equipment and adds the number of 
available tracks (tracks not currently assigned to a file) for a device to the appropriate counter for each 
mass storage device found in the EST. TRACER obtains this information from TDGL of the MSTF. 



PROBE UTILITY 

The PROBE utility measures the following: 

• The number of times a PP routine was loaded. 

• The number of CIO RA+1 requests by function number. 

• The number of PP requests to CPUMTR by function number. 

• The number of MTR requests to CPUMTR by function number. 

• The statistical data accumulated in low central memory; includes such items as number of 
sectors rolled and number of rollouts. 

PROBE data gathering is selectable at deadstart time by an IPRDECK entry. 
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PROBE CONTROL STATEMENT 

The PROBE utility generates a report from the data collected by the system. PROBE analyzes data 
either from system tables or from a file containing data from a previous PROBE run. An IPRDECK entry 
PROBE must be specified at deadstart time to allow the system to collect the data. (Refer to the 
Installation Handbook for more information.) 

PROBE control statement format: 

PROBE (p b p 2 ,...,Pn) 
p. Description 

P=lfn! Binary file to be written. 

Default is STATS. 

p=0 No binary file is to be written. 

L=lfn2 Report file. 

Default is OUTPUT. 

L=0 No report is to be generated. 

B=lfn 3 Binary file to be read. 

Default is STATS. 

R Rewind binary files before and after operation. 

Default is no rewind. 

OP=p Processing option. 

Default is P. 

C Perform R option functions and clear systems tables after they 

are read. 

P Generate report from binary files specified by the B parameter. 

R Read system tables, and write binary file and report file as 

specified. 

LO=x Sort option for PP program load information. 

F Sort data by frequency of loads (default sort option). 

R Sort data by location and frequency of loads. 

A Sort data in alphabetic order. 



NOTE 



The file names must be unique. If the OP 
parameter is equal to R or C, the P parameter 
cannot be equal to zero. 



Figure 15-2 is an example of the PROBE output file format. 
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PRfm VERSION 1.0. B0/09>?6. 16.PF.19. PAG* 

PPOBE VEKS T 0N i.O P0/0V?e. 13.*?.i»l, 

START OP SAMPLE ^Tr^v^L *0/0V. 16.1"^.^. 

END OF 9»MO|_c jMTEfV^L R0/D1/?f. 16.?*. 10. 

MONITOR PEr<UES T S 





PPOGRAM MODE 


MONT TOP 


mhoc- 




ro»jO 


lO'lC 


C"Ut 


*BTMf^i») 





2 


o 


CCA^(7«?) 


n 


9 





CEPHAS) 





2 





TCPPC^M 





IP 


o 


SFIM(<»0* 





*1 





9TKMCH1 


pi 


Q l 


n 


DPFM(t»?1 





IOC** 





HCSHfUS^ 








f) 


9CLH.C*** 





10<>P6 





RCPVfb*) 





2 


o 


RDCNfUM 


?t 


3 


o 


IAUHf<ff ) 


f* 


b 


o 


ACTM(«?0> 


9 


G 





PFPW(*1> 





4~9 





PSJMt*21 





*6 





STC*f531 


** 


f-e 


o 


SFBM(c u> 





??? 


o 


STPMC55* 





i°i 





UACMIP6* 





?** 


o 


SPLM(?7) 





i?.?k 


o 


JACM<*r>} 





?i 


o 


OL*M( fe ll 





o 


o 


TDAMf*i?l 








o 


TI0M(S31 








9 


PLMHfftu* 





?*» 


o 


LCEMf*5> 








o 


CSTMfAfcl 


It 


1? 





CKSH(*f) 


t) 





o 


LDAMC^Ql 





fcM 





VMS*m> 


'5 


7 5 


o 


PIOMC*! 








o 


0FHMC3) 


n 


a 


o 


(*U» 











(?5* 











SUBTOTAL 




l<*? r 2 





TOTAL 


??* 




1>95 2 



Figure 15-2. Example of PROBE Output (Sheet 1 of 6) 



15-24 



60455380 G 



P?0"*E VERSION 1.0. 



80/09/25. 16.25.19. P^r 



MTR REQUESTS 





CPHO 


<*PU1 


aRTFf n 


575 


o 


IAPP( 21 


6 


H 


EPPFt ^> 


1459 





MRAPt <*1 


1653 


(} 


MFLFC 5* 


19085 


p 


SCSF( 6* 


13 


U 


SMSF( M 





ft 


CMSF(IO) 





5 


ROLFCU1 








flCSFCl?) 


16341 





PCXFtlSI 





c 


APHFUM 





D 


MRFFf1«?1 





n 


MFEPT1M 





5 


SUBTOTAL 


39132 


n 


TpT ** 


39132 





PROGRAM M OPF 





CP'fi? 


HSTP( 1) 


1459 


pohf( ?y 





RHPFC 31 





MECF< »t> 





TECFf «n 





TO T ai_ 


1459 



j*TR P£PFOP^fiMn c "ftPftMETCOS 

WORST f?AS c *MYM* TME = 
WCPST CAS* C^CLE T I*E = 



6 



CPUHTR aFOFnPHPNfJF P*PAPETERS 

NUM9"P OF C CS STOPAGE HOVE? = 
NUM«E r A F CM ST OP AG- MOVES = 

JOB IN PF*VLL ^UE TO TPU EXCHANGE PEQUtST 



IPO PEP r O^AMC5 '»^? , aME T E S 
NUH^FP OF POLLOUTS = 
^UMq-Tr- r)P SECTORS POLLEO ^ 



I* 
*91 



COU^T OP POLLOU^S FOP USEP LT*T T S = 
**QMN T OP ^TMF SLTOP^ r 



Figure 15-2. Example of PROBE Output (Sheet 2 of 6) 
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CIO REQ'JES"^ 

PUNCTICM C*LLS FUNC'TOM CALLS 
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WPITECOtM 6*? WPTT C *C02U* 11 
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PPO^E VERSION 1.0. 



80/0P'2S. 16.25.19. PAG C 



PPU PROGRAM LOC^S 



NAHE 


LO^ 


Lnaos 


1SJ 


cmp 


**97 


ISP 


rwR 


kbl 


110 


CMP 


!>qq 


pio 


CMO 


22? 


2CP, 


f^M!> 


13P 


1MT 


0*P 


130 


3MG 


CW° 


12^ 


2CC 


CM° 


111 


2CD 


CM 9 


76 


SF* 3 


CMS? 


4fc 


lot 


r«o 


*>1 


9f A 


nsK 


3? 


1AJ 


rii-ip 


35 


TCS 


f!K|!J 


2? 


3AE 


CMR 


1 Q 


GPF 


T*ef3 


18 


2CF 


cm:? 


11 


3AF 


CMP 


11 


6DI 


CMP 


10 


OAU 


PSK 


q 


1CJ 


PSK 


P 


IDS 


OS* 


9 


3SA 


os* 


3 


CMS 


os* 


7 


QA* 8 


nsK 


7 


M39 


ps< 


7 


**DC 


ns< 


7 


<»OG 


PS*< 


7 


701 


CM? 


7 


7EP 


CMP 


7 


1CK 


C MO 


6 


CPM 


PSK 


5 


DSP 


PSK 


c 


QAC 


m? 


I» 


OPP 


nsK 


^ 


QDF 


*>?<? 


<♦ 


1CD 


^SK 


4 


3TA 


OS* 


** 


3IP 


PSK 


<♦ 


30S 


CMP 


if 


5IA 


PSK 


*» 


LFM 


CMR 


■? 


SFM 


hpk 


* 


1RI 


l»M9 


T» 


IPO 


CM" 


3 


2CA 


PM? 


3 


*PA 


PSK 


3 


3PG 


^SK 


3 


3SX 


PSK 


3 


9AA 


PSK 


3 


100 


^Mp 


2 


3*8 


ns< 


2 


3CC 


PSK 


r> 


3LG 


C«P 


2 
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N*MF 


IHC 


LO^DS 


2SC 


3SK 





2S0 


PSK 





2SF 


PSK 





2SG 


0*K 





2SH 


PSK 





2? I 


psk 





?T0 


PSK 





2TN 


n^K 





2T0 


CMR 





3AA 


c-<;k 





3AC 


PSK 





3f0 


PSK 





3AG 


DSK 





BAH 


PSK 





3* T 


PSK 





388 


PSK 


n 

u 


3PC 


PSK 





3PP 


PSK 





3BE 


PSK 





3BF 


OSK 





3CP 


PSK 





7C« 


PSK 





3DY 


psk 





30 Z 


psk 





3FA 


PSK 





3FB 


PSK 





3XC 


PSK 





3T0 


PSK 





3LA 


P^K 





3L9 


<*jMO 





3LC 


p?k 





3LC 


psk 





3LE 


PSK 





3MP 


PSK 





3MC 


PSK 





3MP 


PSK 





3 W E 


P^K 





3VP 


PSK 





3HH 


C M R 





3MT 


PSK 





3HJ 


PSK 





3MK 


PSK 





3Mt 


CMR 





3MM 


PSK 





3HN 


PSK 





3M0 


P?K 





3MP 


0?K 





3«Q 


PSK 





3MP 


PSK 





3MS 


P?K 





3MT 


CMR 





3*11 


PSK 





"3MV 


PSK 





3HW 


PSK 
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PFM 


^1P 


I 


OFA 


^M"5 


i 


0TO 


IS* 


1 


2SF 


r»s* 


1 


*ca 


r»5^ 


1 


30 A 


ns* 


1 


3LF 


<*M3 


1 


3MA 


•v?*. 


I 


3PI 


*>»p 


1 


qpft 


n$w 


i 


ADC 


HSK 


3 


OAT 


OS* 





HFD 


^»S< 





C«»l 


ns* 





CF-i 


n<;< 





cux 


n^Y 





CVL 


ns* 





opr 


^S* 





OIS 


^s* 





OC G 


^S r 





0S1 


n s* 


tJ 


ELM 


"»s* 


n 


eye 


o$< 





C DP 


OS vr 





FTP 


ns* 





HF^ 


"SK 





TLO 


nqk' 





IVS 


ns* 





too 


•'IMP 





LCQ 


OH" 





lor 


r»M*> 





L^l 


nsK 





MLO 


nSK 





OUT 


osk 





026 


*sk 





PFU 


OSK 





PIP 


n$K 





OFH 


ns* 





QTS 


OSK 





Q26 


ns* 





RPV 


rwi? 





SBP 


ns* 





SIP 


ns* 


t! 


SLL 


OS* 





SMP 


OS* 





STM 


ns* 





TLX 


nsK 





TMG 


^S* 





VEJ 


OSK 


13 


WPM 


ns* 





XSP 


t>SK 


1 


OAV 


*»MQ 





OCT 


n SK 





0^1 


"SK 





ORF 


nwo 





OPP 


OMO 





OTT 


ns* 





OVJ 


nc* 






SMY 


OSK 


3PY 


0?K 


3Wf 


OSK 


3PA 


r*t.iQ 


-?co 


OMR 


3PC 


OS* 


3P0 


«MP 


3PF 


OSK 


7PF 


O^K 


yon. 


f^VP 


3PM 


n^K 


3PJ 


O r K 


3PK 


C**P 


3PL 


or* 


■»PM 


OSK 


3P^ 


0*** 


"*FO 


M R 


3PP 


T?K 


30 ft 


C K 


3Q« 


OSK 


3QC 


C K 


3Pr 


C K 


3PP 


OSK 


30T 


l*\t 


30 U 


OSK 


'PC 


OSK 


•*BP 


I^K 


3RH 


IV'P 


3PI 


OSK 


3PF 


C^P 


3P0 


V P 


3SY 


OSK 


"*S"» 


OS* 


3Tfl 


OS* 


3TP 


O^K 


3T r 


OS* 


3T0 


O^K 


7 TE 


osk 


3TF 


OSK 


3TG 


OS* 


3TH 


o c * 


3TT 


OSK 


rj 


0^'F 


7T* 


C k 'P 


3TL 


OSK 


3TM 


OS* 


3TM 


OSK 


3T0 


OSK 


tOA 


OS* 


tec 


C K 


**DF 


O^K 


hr.e 


C K 


i»DH 


hsk 


5P* 


1SK 


5PP 


OSK 


*CU 


OSK 


£FF 


OS* 


5FH 


OS* 
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IDC 


(•to 





lED 


CSK 





ITS 


ns^ 





1LO 


1SK 


g 


1LS 


DS* 





1L^ 


csx 





IMA 


^H? 


9 


1M9 


ns^ 


a 


IMP 


ns^ 


i 


1MR 


^SK 


n 


1»M 


nsK 


n 


1RP 


cs<< 


3 


1SI 


csx 





IT 4 


Cmp 


t) 


1TD 


csk 


g 


1TE 


CSK 





1TN 


csk 


9 


1TO 


"mj> 





i T ° 


ns^ 





ITS 


^S* 


r» 


?cp 


CMP 





2CG 


CM 1 ' 





2CH 


C M3 





2CI 


C*R 





2CJ 


C^K 





2CK 


*SK 





2CI 


DS< 





210 


^S;^ 





2TN 


cs<< 





2TP 


CSK 





2TQ 


?sx 





?IR 


1SK 





2L0 


IS* 





2PA 


os* 





2MB 


1>SK 





2MC 


1SK 





2RP 


ns* 





2SA 


osx 


n 


2SB 


cs< 





2SC 


r»Svr 






NUMPER OF fS^ PROQPAMS 

NUMBER i* '"MP PROGRAMS 

NUMBER HF CSK PROGPfl^S 

NUMPER CP PLO FNTc»TfS • 



FTC 


CSK 


FTQ 


3f X 


*TE 


C C K 


5TG 


hsk 


FTH 


n c« 


ELL 


OSK 


cvc 


C-SK 


FMP 


D C K 


5MS 


CSK 


CMT 


OSK 


CHU 


TS^ 


5MW 


1SK 


5SU 


1 C K 


5 SI' 


OSK 


5<+l 


C5K 


5 C X 


CSK 


56 X 


3SK 


57 X 


1SK 


5«F 


TCK 


5SH 


C^K 


58X 


C C K 


6*0 


C M R 


^MC 


5»R 


7pP 


C M R 


TST 


C^F 


7WI 


C M P 


*XA 


CSK 


pyp 


T-^K 


sxc 


1SK 


°Ai 


C M R 


9A5 


Cf**R 


9A6 


CHR 


9* 7 


^MP 


9GA 


DSK 


QTft 


C C K 


«JA 


C-SK 


gpfl 


1SK 


S T A 


C°K 


97A 


3SK 


r 




7t 




229 




?Q? 
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DIAGNOSTICS 



This appendix contains diagnostic messages issued by routines and utilities documented in this manual. 
Messages are listed alphabetically; leading nonalphanumeric characters are ignored for this purpose. 
Messages whose first character is a digit follow those at the end of the alphabet. Lowercase letters in a 
message indicate a variable field; such fields are explained in the accompanying message description. 
Messages beginning with a variable field are located at the end of the appendix. 

If you encounter a diagnostic or informative message that does not appear in this appendix, consult the 
NOS Diagnostic Index. This publication catalogs all messages produced by NOS and its products and 
specifies the manual or manuals in which each message is fully documented. 
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MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



ABORT RUN DUE TO ERRORS. 

ACCESSED AFTER yy/mm/dd. hh.mm.ss. 

ACCESSED BEFORE yy/mm/dd. hh.mm.ss. 

ACCOUNT DAYFILE DUMPED. 
ACTIVE FILES ON DEVICE. 

ACTIVE LOAD NOT ALLOWED. 

ADDCUBE - ONLY 100 LOCATIONS PROCESSED. 



ADDRESS OF OVERLAY ovl IS NOT SAME AS 
OVERLAY AREA. 



AFD - ARGUMENT ERROR. 



AFD - BUFFER TOO SMALL. 



AFD - CHECKPT BOUNDARY ENCOUNTERED. 



AFD - DATA LOST. 



The ASVAL run aborted because of errors on 
the control statement . 

Informative message Indicating that files 
accessed after the date and time specified 
have been loaded (or dumped). 

Informative message indicating that files 
accessed before the date and time specified 
have been loaded (or dumped). 

The account dayfile dump is complete. 

Device initialization was attempted on a 
device with activated fast-attach files. 



The load is not allowed because the device 
selected to receive active queues is 
removable. 

At most 100 cubicles can be added. The 
coordinate pairs specified by the XI and YI 
parameters encompass more than 100 cubicles. 

The address of overlay ovl in the overlay 
area header is different from that in the 
overlay header, possibly indicating a bad 
CCP binary input file. 

Keyword specified is not recognizable or 
control statement is not properly formatted. 



The buffer DAYFILE uses to hold the central 
memory dayfile buffer is not large enough. 



The utility has encountered an EOR or EOF 
written by a system checkpoint operation. 
The utility discards any incomplete dayfile 
message fragments and continues with the 
first message following the E0R/E0F. 

A data read error occurred while processing 
an active dayfile. Processing continues 
with the next readable message. Lost data 
is not recoverable. 



Correct errors and 
retry. 

None. 



None. 



None. 

Use the R option on the 
ISF control statement to 
release these files. 

Select another device 
and retry the load. 



Use multiple AB 
directives. 



Check CCP binary input 
file. Correct error 
and try again. 



Check keyword and 
control statement 
formats. 

Either make the internal 
DAYFILE buffer larger or 
specify a smaller 
dayfile buffer during 
deadstart. 

None. 



Inform site analyst. 



ASVAL 



PFLOAD, 
PFDUMP 



PFLOAD , 
PFDUMP 



DAYFILE 
MSI 

OLOAD 

ASLABEL 

LFG 

DAYFILE 
DAYFILE 

DAYFILE 

DAYFILE 



•n 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



AFD - FILE /CM BUFFER BOUNDARY ERROR. 



AFD - FILE TOO LONG. 



The disk resident portion of the dayfile 
cannot be joined correctly with the CM 
buffer portion. 

The active dayfile being processed is 
longer than the system reservation status 
indicates. 



Inform site analyst. 



Inform site analyst. 



DAYFILE 



DAYFILE 



AFD - FILE TOO SHORT. 



The active dayfile being processed is 
shorter than the system reservation status 
indicates. 



Inform site analyst. 



DAYFILE 



AFD - FR INVALID FOR THIS OPTION. 



The FR=string parameter is not allowed with 
this utility. 



Use an appropriate 
option or omit the 
FR=string parameter and 
retry. 



DAYFILE 



AFD - ILLEGAL PAGE SIZE FORMAT. 



The page size value is nonnumeric. 



Retry with a numeric 
value . 



DAYFILE 



AFD - ILLEGAL PRINT DENSITY. 



AFD - ILLEGAL PRINT DENSITY FORMAT. 



AFD - READ ERROR ON SEARCH FILE. 



AFD - RESERVED FILE NAME. 



AFD - UNKNOWN *0P* FIELD. 



ALL FILES FOR USER INDEX userin. 



ALTERING FLAW MAP S/N=serialn. 



ALTERNATE DEVICE NOT FOUND. 



The print density value is not 3, 4, 6, or 



The print density value is nonnumeric. 
Print density must be 3, 4, 6„ or 8. 

A read error occurred during the 
incremental dump and search option 
processing. 

The file name specified for the L=lfn 
parameter is a reserved name. 

The option specified is not valid. 



Informative message indicating that all 
files with user index userin have been 
loaded (or dumped) . 

Console message indicating that the utility 
flaw map is undergoing modification. Here 
serialn is the actual pack serial number as 
read from the manufacturing data recorded in 
cylinder 6328 (or 1466B), track 0, sector 0. 

Device on which a direct access file is to 
be loaded (specified in catalog) is not 
available in this system and an alternate 
(default) device was not specified; file is 
skipped. This message applies only to direct 



Retry with a valid print 
density. 

Retry with a valid print 
density. 

Retry the command. 



Retry using a 
nonreserved name. 

Retry using a valid 
option. 

None. 



None. 



To load the skipped file, 
rerun the utility and 
specify an alternate 
device on which the file 
may be loaded (DD 



DAYFILE 



DAYFILE 



DAYFILE 



DAYFILE 



DAYFILE 



PFLOAD , 
PFDUMP 



FORMAT 



PFLOAD 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



access files, is a nonfatal system error, 
and is accompanied by the message PFLOAD - 
STATUS ERR. 



option) 



ALTERNATE FILE ACTIVE. 



Output file message indicating that the 
alternate file was already being processed 
when entry of the OUTPUT directive was 
attempted. 



Wait until processing is 
complete to enter the 
OUTPUT directive. 



DSD I 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



m 



ALTERNATE OUTPUT TO TERMINAL ILLEGAL. 



Output file message indicating that the file 
name OUTPUT was specified on the OUTPUT 
directive entered from a terminal. Alter- 
nate list output cannot be assigned to the 
terminal. 



Specify a file name 
other than OUTPUT on the 
OUTPUT directive when it 
is entered from a 
terminal . 



DSD I 



ARGUMENT VALUE MISSING. 



ASDEBUG ABNORMAL, xxx. 



ASDEBUG COMPLETE. 



ASDEBUG ERROR xxx. 
DIRECTIVE yyy. 



Output file message indicating that a pi= 
was encountered but not equivalenced. 

There is an ASDEBUG internal error in module 
xxx. 



Informative message indicating that ASDEBUG 
completed normally. 

First two lines of a three-line message 
indicating that error xxx was encountered 
during the processing of directive yyy. 
The third line of the message gives more 
details about the error. 



Rerun using correct 
value . 

Submit a Programming 
System Report (PSR) with 
supporting material. 

None. 



Refer to the ASDEBUG 
report file for a copy 
of the directive. 
Refer to the message 
given in the third line 
for more information 
about appropriate 
action to be taken. 



VALNET 



ASDEBUG 



ASDEBUG 



ASDEBUG 



ASDEBUG, NO DIRECTIVES. 



The directive file is empty or not rewound. 



Add a directive to the 
file or rewind the 
directive file. 



ASDEBUG 



ASDEF ABNORMAL, xxx. 



There is an ASDEF internal error in module 
xxx. 



Submit a Programming 
System Report (PSR) with 
supporting material. 



ASDEF 



ASDEF ABORT - ILLEGAL CS VALUE. 



ASDEF ABORT - NO PARAMETER SPECIFIED. 



ASDEF ABORT - SYNTAX ERROR. 



The CS parameter on the ASDEF control 
statement was not a letter from A through M. 

Neither the CS nor the FM parameter was 
specified on the ASDEF control statement. 

The ASDEF control statement is syntactically 
incorrect. 



Correct the CS parameter ASDEF 
and retry. 

Specify at least one CS ASDEF 
or FM parameter. 

Correct the parameters ASDEF 
on the control statement 
and retry. 



ASDEF COMPLETE. 



ASDEF ERRORS. 



Informative message indicating that ASDEF None, 
completed normally. 

Informative message indicating that ASDEF None, 
completed normally with the errors reported 
in the dayfile. 



ASDEF 



ASDEF 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



ASLABEL ABNORMAL, xxx. 



ASLABEL COMPLETE. 



ASLABEL ERROR xxx. 
DIRECTIVE yyy. 



ASLABEL - NO DIRECTIVES. 



ASMOVE ABNORMAL, xxx. 



ASMOVE COMPLETE. 



ASMOVE - SYNTAX ERROR. 



ASSIGN FILE. 



ASSIGN TAPE. 



ASSIGNED FILE CONFLICT - SDF. 



ASSIGNED TTYS GREATER THAN (NT) 



AST CORRECTION. 
DESTAGE DELAYED, 
FM-family, SF-sub, CSU-id. 



There is an ASLABEL internal error in module 
xxx. 



Informative message indicating that ASLABEL 
completed normally. 

First two lines of a three-line message 
indicating that error xxx was encountered 
during the processing of directive yyy. 
The third line of the message gives more 
details about the error. 



The directive file is empty or not rewound. 



There is an ASMOVE internal error in module 
xxx. 



Informative message indicating that ASMOVE 
completed normally. 

The ASMOVE control statement is 
syntactically incorrect. 



The archive file to be copied has not been 
assigned. 

The archive tape containing files to be 
cataloged or loaded has not been assigned. 



A local file named SDF is assigned at the 
control point. SDF is a reserved file name. 

Nonfatal K-display message indicating that 
the number of terminals assigned to sessions 
is greater than the number of terminals 
being stimulated. 

An error with the AST was corrected. The 
destage of the affected file will be 
automatically restarted. 



Submit a Programming 
System Report (PSR) with 
supporting material. 

None. 



Refer to the ASLABEL 
report file for a copy 
of the directive. Refer 
to the message given in 
the third line for more 
information about 
appropriate action to 
be taken. 

Add a directive to the 
file or rewind the 
directive file. 

Submit a Programming 
System Report (PSR) with 
supporting material. 

None. 



Correct the parameters 
on the control statement 
and retry. 

Assign archive file 
to be copied. 

Ensure that the correct 
archive tape (created 
by PFDUMP) is assigned. 

Rename the local file. 



Reduce the number of 
terminals assigned by 
using the MX entry. 



None. 



ASLABEL 



ASLABEL 



ASLABEL 



ASLABEL 



ASMOVE 



ASMOVE 



ASMOVE 



PFCOPY 



PFATC 



IIS 



STIMULA 



EXDEST 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



a 



AST SUBSTITUTED. 

PFN-filenam, FAMILY-family, Ul-userin. 

SUBCATALOG CSU ID - id. 



The AST was rebuilt because it no longer 
matched the FCT. 



None. 



MSSEXEC 



ASUSE ABNORMAL, xxx. 



There is an ASUSE internal error in module 
xxx. 



Inform site analyst. 



ASUSE 



ASUSE COMPLETE. 



ASUSE - SYNTAX ERROR. 



ASVAL ABNORMAL, xxx. 



Informative message indicating that ASUSE 
completed normally. 

The ASUSE control statement is syntactically 
incorrect. 

There is an ASVAL internal error in module 
xxx. 



None. 



Correct the control 
statement and retry. 

Inform site analyst. 



ASUSE 



ASUSE 



ASVAL 



ASVAL COMPLETED. 



ATTACH ERROR ON filenam. 



ATTACH ERROR ON MSF CSUMAP. 
PFN-filenam, FAMILY-family, Ul-userin. 

ATTACH ERROR ON MSF SUBFAMILY CATALOG. 
PFN-filenam, FAMILY-family, Ul-userin. 

AUTOMATIC NAME ASSIGNMENT IMPOSSIBLE. 



Informative message indicating that ASVAL 
completed normally. 

MSSEXEC was unable to attach file filenam. 



System error. 



At least one but fewer than eight subfamily 
catalogs exist for the family. 

DFTERM was unable to determine an available 
name for the terminated dayfile. 



None. 



Ensure that the file is 
direct access and not 
in use, and then retry. 

Recover or create the 
missing CSU map. 

Recover the missing 
catalogs. 

Enter a valid name for 
the file using the K 
display. Use the NM 
directive to override 
automatic name 
assignment. 



ASVAL 



ASDEBUG 



MSSEXEC 



MSSEXEC 



DFTERM 



BAD DUMP FILE. 



Dump cannot be written on the specified 
file. 



Request another dump 
file. 



QDUMP 



BAD SYSTEM POINTER. 



Output file message indicating that: a bad 
system pointer was detected in the EDD 
file during processing of an input 
directive. 



Ensure that the dump 
file contains 
meaningful information 
(can use P option on 
DSDI to cause use of 
low core pointers from 
running system) and 
rerun. 



DSDI 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



BAD SYSTEM SECTOR filenam userin. 



BLOCK SEQUENCE MISMATCH, 
filenam STAGING ERROR, JOB-jobnam, 
FM«family, Ul-userin, CSU-id, MST-n, 
VSN-vsn, ASA-addr, STRM-s. 



Error was encountered in system sector of 
direct access file filenam during dump 
to archive tape; file is skipped. This is 
a nonfatal system error. 



The staging of file filenam was aborted 
because of a block sequence error, which was 
detected during the stream label 
verification procedure or the file label 
verification procedure. All jobs attempting 
to attach this file will be aborted or given 
an error response. The stream conflict 
error flag is set in the MSF catalog entry 
for the affected cartridge and stream. 



Inform site analyst. 
System sector for 
specified file must 
be corrected before it 
can be dumped. 

Retrieve the file from 
a dump tape if a 
backup copy is 
available. Run ASVAL 
to identify other 
files, if any, that are 
affected by this error. 
Either remove and 
reassign the cartridge 
or run ASDEBUG to clear 
the stream conflict 
error flag. Refer to 
Error Conditions and 
Corrective Action in 
section 3. 



PFDUMP 



EXSTGE 



BOTH FAMILY AND PACK NAME. 



Family and pack name cannot both be 
specified. 



Correct error and retry. 



PFS 



BUFFER ARG. ERROR FROM *VEJ*. 



When called to assign a file to mass 
storage, VEJ returned a buffer argument 
error. 



Inform site analyst. 



QLOAD 



BUFFER ARGUMENT ERROR. 



BUFFER SIZE TOO SMALL FOR DUMP FILE 
RECORD x. 

CANNOT ATTACH *IQFT* FILE. 



CANNOT CATLIST FAMILY /PACK-fampck. 



CANNOT FIX VSN FOR GOOD LABEL. 



CANNOT LOCATE DUMP NUMBER dmp. 



One of the FET pointers is outside the 
caller's field length. 

Record x is too large to be read into the 
allocated buffer space. 

An attempt to attach the IQFT file on the 
destination device failed. 



DFTERM was unable to perform a CATLIST 
operation on the family/pack fampck. 



The cartridge specified in the FX directive 
to ASLABEL already has a good label. 

User-specified dump number dmp cannot be 
found in the dump directory. 



Examine program to 
determine error. 

Allocate a larger 
buffer and try again. 

Check for other utilities 
accessing the file. When 
the file is free, retry 
the load operation. 

Ensure that catalogs 
exist on the family /pack 
and retry the operation. 

Add or restore the 
cartridge to the CSU. 

Analyze error and 
try again. 



LOADBC, 
1LC 

NDA 



QLOAD 



DFLIST, 
DFTERM 



ASLABEL 



NDA 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



W 



CANNOT LOCATE START ADDRESS. 



CARTRIDGE NOT ASSIGNED AS EXPECTED. 



CARTRIDGE NOT EMPTY, vsn. 



CARTRIDGE NOT FOUND. 



CARTRIDGE PRESENT - LOST BIT SET. 



CATALOG COMPLETE. 



The record containing the beginning NPU 
address on the NDA call cannot be found. 

One of the cartridges specified has a vsn 
that does not allow the assignment or 
removal specified by a directive to ASLABEL. 

The cartridge, whose volume serial number 
is vsn, cannot be removed because it still 
contains file data. 

The cartridge is not in its assigned 
cubicle. 



The lost (LT) option was specified on the RM 
directive to ASLABEL, but the cartridge is 
physically present. 

Informative message indicating that 
cataloging or the list run is complete. 



Analyze error and 
try again. 

Correct the directive to 
ASLABEL and retry. 



None. 



Locate and restore the 
missing cartridge or 
change the directive to 
ASLABEL or ASDEBUG to 
select a different 
cartridge. 

Clear the lost flag in 
the MSF catalog. 



None. 



NDA 



ASLABEL 



ASLABEL 



ASLABEL, 
ASDEBUG 



ASLABEL 



CATALOG, 
MODVAL , 
PFATC 



CATALOG CONTROL WORD MISSING. 



CATALOG FORMAT ERROR. 



CATALOG INDEX OUT OF RANGE. 



CATALOG LOST BIT MUST BE SET. 



CATALOG /MAP FILE INTERLOCKED. 



Either the catalog control word was not 
the initial control word on the archive 
file, or the entire catalog entry is not 
present. This is a nonfatal system error 
and is accompanied by the message TAPE 
ERROR filenam userin. 

An attempt was made to catalog a permanent 
file device which was created on a system 
whose permanent file catalog format is 
different from that used by the currently 
running system. 

Location of catalog buffer is not in 
buffer range. This is a fatal system 
error; PFDUMP aborts. 

The lost (LT) option was specified on the 
RM directive to ASLABEL, but the cartridge 
is not known to be lost. 

Another utility is using the CSU map or MSF 
catalog required to process the directive to 
ASLABEL . 



Retry or use backup tape. 



PFCOPY 



Dump and reload the 
affected file. 



Retry PFDUMP operation. 



Correct the directive 
and retry. 



Rerun at a later time. 



PFCAT 



PFDUMP 



ASLABEL 



ASLABEL 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



CATALOG /MAP INTERLOCKED. 



CATALOG /MAP NOT OPEN. 



CATALOG /MAP NOT OPENED. 



CATALOG MISSING FOR FAMILY family. 
UNABLE TO PROCESS MOVE REQUEST FILE. 

CATALOGING filenam userin. 



CATALOGING COMPLETED. 



CATALOGS MODIFIED. 



CATALOGS NOT MODIFIED. 



CHcc, ABORT, ALL DATA NOT TAKEN. 



CHcc, ABORT, Fffff. 



CHcc, ABORT, NO GENERAL STATUS. 



CHc c, ABORT, Snnnn. 



CHcc,MAttt,Avv,LOAD COMPLETE. 



Another utility is using the CSU map or MSF 
catalog required to process the directive 
to ASDEBUG. 

The CSU map or MSF catalog was created after 
the last initialization of MSSEXEC. 



The CSU map or MSF Catalog was created after 
the last initialization of MSSEXEC. 



ASMOVE was run on a family that has no MSF 
catalogs. 

Informative message indicating which file 
and user index are being cataloged. 

Informative message indicating that 
cataloging is complete. 

Informative message indicating that ASVAL 
repaired the MSF catalogs. 

Informative message indicating that ASVAL 
did not repair any MSF catalogs. 

The controller did not accept all the data 
on an attempt to download controlware. 

Function ffff timed out while accessing the 
controller. 

After a download of controlware completed, 
the controller did not return a general 
status word after a status function. 

An error in the general status of the 
controller occurred after the controlware 
was loaded. 

cc Channel on which controlware was 
loaded 

nnnn General status of the controller 

Informative message indicating that the 
controlware was successfully loaded. 

cc Channel on which disk controlware 
was downloaded 

ttt Controlware type (401, 710, or 721) 



Rerun at a later time. 



Idle down and restart 
MSSEXEC before rerunning 
the directive to 
ASDEBUG. 

Idle down and restart 
MSSEXEC before rerunning 
the directive to 
ASLABEL. 

Correct the FM parameter 
and rerun ASMOVE. 

None. 



None. 



None. 



None. 



Inform customer 
engineer. 

Inform customer 
engineer. 

Inform customer 
engineer. 

Inform customer 
engineer. 



None. 



ASDEBUG 



ASDEBUG 



ASLABEL 



EXUCP 



PFATC, 
PFCAT 

PFCAT 



ASVAL 



ASVAL 



LOADBC 



LOADBC 



LOADBC 



LOADBC 



LOADBC 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



M 



CHANNEL NUMBER ARGUMENT ERROR. 



vv Version number (12, 13, 14, ...) 

The ARG common deck routine reported an 
error in the channel number supplied on the 
LOADBC control statement. 



Check the C-cc parameter 
and retry. 



LOADBC 



CHANNEL NUMBER OUT OF RANGE. 



Output file message indicating that the 
channel specified was not between and 1 3B 
or 20B and 33B. 



Correct and rerun. 



VALNET 



****CHARGE NUMBER ACTIVE. 



****CHARGE NUMBER DOES NOT EXIST. 



****CHARGE NUMBER INACTIVE. 



CHECK DAYFILE FOR ERRORS. 



Output file message indicating that the 
user has attempted to activate an already 
active charge number. 



Output file message indicating that a 
directive for which the charge number must 
exist has made a reference to a charge 
number that does not exist. 

Output file message indicating that a 
directive for which the charge number must 
be active made a reference to a charge 
number that is inactive. 

Informative message indicating that the 
user should check the dayfile for errors. 



Rerun using correct 
charge number or 
directive, if 
necessary. 

Rerun using the correct 
charge number. 



Activate charge number 
and rerun, or rerun using 
correct charge number. 



Examine error messages 
in dayfile. 



PROFILE 



PROFILE 



PROFILE 



COPY, 

PFATC, 

PFCAT, 

PFCOPY, 

PFDUMP, 

PFLOAD , 

TCOPY 



CHECK OUTPUT FOR WARNING MESSAGES. 



CIO ERROR. 



CIO ERROR ON MSF CSUMAP. 

PFN-filenam, FAMILY-family, Ul-userin. 



CIO ERROR ON MSF SUBFAMILY CATALOG. 
PFN-filenam, FAMILY-family, Ul-userin. 



No directive errors were encountered, but 
certain input directives (on create or 
update) received warning messages. 

A parity error was encountered while file 
MOVCOM was being written. 

A CIO error was encountered while the CSU 
map was being read. 



A CIO error was encountered while the MSF 
catalog was being read. 



Check output listing. 



Purge MOVCOM. 



Investigate cause of 
error and take 
appropriate action. 

Investigate cause of 
error and take 
appropriate action. 



MODVAL 



ASMOVE 



EXINIT 



EXINIT 



CKLAB - ABNORMAL TERMINATION. 



The label from stream zero contains the 
wrong stream number. 



Restore label with the 
FX directive to ASLABEL. 



ASLABEL 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



CLEARING PF ACTIVITY COUNT. 



CLEARING UTILITY INTERLOCK. 



CM RECORD NOT FOUND. 



COMMA AFTER itm MISSING. 



PFCAT is waiting for PFU to decrement the 
permanent file activity count because cat- 
alog processing has been completed. This 
message should be displayed for a few 
seconds only. 

PFLOAD is waiting for PFU to clear the 
permanent file utility interlock on a 
device after it is loaded. This message 
should be displayed for a few seconds only. 

Dayfile and output file message indicating 
that the central memory record was not found 
in the EDD file. 



Expected comma after item itm was missing. 
Scan continues with next item. 



Inform site analyst if PFCAT 
message is displayed for 
an extended period of 
time. 



Inform site analyst if PFLOAD 
message is displayed for 
an extended period of 
time. 

Ensure that the dump DSDI 

file contains meaningful 
information and is 
positioned correctly. 

None . LFG 



COMMUNICATION FILE BUSY, 



COMPARE FILE DEFINE ERROR, 
filenam FOR jobnam NOT STAGED. 



COMPARE FILE PURGE ERROR, 
filenam FOR jobnam NOT STAGED. 



CONNECT TO EXEC FAILED. 



The communication file MOVCOM is busy. 



The staging of file filenam for job jobnam 
was abandoned because of a system error. 



The staging of file filenam for job jobnam 
was abandoned because of a system error. 



ASVAL is not running at full capacity 
because MSSEXEC is not running. No MSS 
release processing or catalog repair 
processing is done but a validation report 
is produced. 



Rerun ASMOVE when ASMOVE 

MOVCOM is no longer 

busy. 

Submit a Programming EXSTGE 

System Report (PSR) with 
supporting material. 

Submit a Programming EXSTGE 

System Report (PSR) with 
supporting material. 

None. ASVAL 



CONTROL CARD ARGUMENT ERROR. 



Dayfile message indicating that Invalid 
control statment arguments have been 
encountered. 



Correct and retry 
operation. 



QFSP 



CONTROL CARD SYNTAX ERROR. 



CONTROLLER DID NOT TAKE ALL THE CONTROLWARE. 



The ASVAL control statement is syntactically 
incorrect. 

The controller did not accept all the data 
in the controlware record. The contents of 
a register did not equal zero after one of 
the OAM instructions in the PP. 



Correct errors and 
retry. 

Inform customer 
engineer. 



ASVAL 



LOADBC 



O 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



CONTROLWARE LOAD ABORT, C-cc. 



First line of a two-line message indicating 
that controlware was not successfully 
loaded on channel cc . The second line of 
the message indicates the reason for the 
abort • 



Refer to the message 
given in the second 
line for information 
about appropriate 
action to be taken. 



LOADBC 



CONTROLWARE LOAD COMPLETE. 
yyyFIRMWARE MAttt-wv,C«cc 



Informative message indicating that the 
controlware was successfully loaded. 

yyy Controller type 

ttt Controlware type 

vw Version number 

cc Channel number 



None. 



LOADBC 



CONTROLWARE NOT FOUND. 



The system file does not contain the 
requested controlware. 



Check the system 
controlware records. 



LOADBC 



CONVERSION ERROR. 



CONVERSION ERROR. 



Dayfile message indicating that a character 
has been entered after a postradix, or an 8 
or a 9 is present in a number with a post- 
radix of B. 

The SU and/or SL parameter on the ASUSE 
control statement was not numeric. 



Correct and rerun. 



Correct the parameter 
and retry. 



SCRSIM 



ASUSE 



CONVERSION TO SOURCE COMPLETE. 



Dayfile message indicating that source run 
successfully completed. 



None. 



MODVAL 



COPYING filenam userin. 



CREATED AFTER yy/mm/dd. hh.mm.ss. 



CREATED BEFORE yy/mm/dd. hh.mm.ss. 



Informative message indicating that file None. 

filenam with user index userin is being 

copied. 

Informative message indicating that files None, 
created after the specified date and time 
have been loaded (or dumped) . 

Informative message indicating that files None, 
created before the specified date and time 
have been loaded (or dumped). 



PFCOPY 



PFLOAD , 
PFDUMP 



PFLOAD , 
PFDUMP 



CREATING use mum. 



Message displayed at line 1 of control point 
indicating that the user number usernum 
is being created. 



None. 



MODVAL 



CREATING CATALOG IMAGE RECORD. 



Informs operator that the catalog image 
record from the archive file is being copied 
to a scratch file. 



None. 



PFLOAD 



CREATION COMPLETE. 



Dayfile message indicating that creation run 
successfully completed. 



None. 



MODVAL 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



CREATION DATE MISMATCH, 
filenam STAGING ERROR, JOB-jobnam, 
FM-family, Ul-userin, CSU-id, MST-n, 
VSN-vsn, ASA-addr, STRM-s. 



The staging of file filenam was aborted 
because the file's creation date and time 
in the PFC entry on disk did not agree with 
the PFC entry on MSF. All jobs attempting 
to attach this file will be aborted or given 
an error response. The stream conflict 
error flag is set in the MSF Catalog entry 
for the affected cartridge and stream. 



Retrieve the file from 
a dump tape if a 
backup copy is 
available. Run ASVAL 
to identify other 
files, if any, that are 
affected by this error. 
Either remove and 
reassign the cartridge 
or run ASDEBUG to clear 
the stream conflict 
error flag. Refer to 
Error Conditions and 
Corrective Action in 
section 3. 



EXSTGE 



CSU ALREADY DEFINED. 



CSU EST ERROR xx. 
DESTAGE RESTARTED. 

CSU id INPUT DRAWER EMPTY, 



CSU id INPUT DRAWER d EMPTY. 



CSU id OUTPUT DRAWER NOT EMPTY. 



The CSU to be added to the subfamily has 
already been added to that subfamily. 

A file destage operation was restarted 
although a CSU EST entry (xx) was incorrect. 

A cartridge is needed from the input drawer 
of the cartridge storage unit (CSU id) to 
process the directive to ASLABEL or ASDEBUG. 
id CSU identifier (A through M) 

A cartridge is needed from slot d of the 
input drawer of the cartridge storage unit 
(CSU id) to process the directive to 
ASLABEL or ASDEBUG. 

id CSU identifier (A through M) 

An empty slot in the output drawer of the 
cartridge storage unit (CSU id) is needed to 
process the directive to ASLABEL or ASDEBUG. 
id CSU identifier (A through M) 



Add a different CSU. 



Check the indicated EST 
entry for the CSU. 

Put the required 
cartridge into the 
input drawer. 



Put the required 
cartridge into the 
input drawer slot. 



Remove cartridges from 
the output drawer. 



ASLABEL 



EXDEST 



ASLABEL, 
ASDEBUG 



ASLABEL, 
ASDEBUG 



ASLABEL, 
ASDEBUG 



CSUMAP ERROR FLAG NOT SET IN FCT. 



CSUMAP OPEN ERROR. 



The RL directive to ASDEBUG did not remove 
the FCT entry in the MSF Catalog because the 
CSU map error flag was not set in the FCT 
entry. 

The CSU map does not exist or is invalid for 
the specified CSU. on the NOS default family. 



Correct the FCT ordinal 
and the SB and CS 
parameters and retry. 



Correct the CS parameter 
on the ASVAL control 
statement or reload/ 
recreate the CSU map. 



ASDEBUG 



ASVAL 



W 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



O 



CSUMAP PARITY ERROR. 



CSUMAP READ ERROR. 



CUBE EMPTY - CSUMAP ENTRY REMOVED. 



CUBES ASSIGNED TO SUB-FAMILY. 



CYCLE STILL PROCESSING. 



There is a read parity error on the CSU map. 

A parity error was encountered on the CSU 
map. 

Informative message indicating that the 
cubicle corresponding to the CSUMAP entry 
being removed with an RC directive was empty. 

The CSU cannot be removed from the subfamily 
because it contains cubicles that are still 
assigned to the subfamily. 

Dayfile message indicating that a command 
other than END. was entered before the total 
time limit was reached . 



Recover the CSU map from 
a backup copy and retry. 

Recover the CSU map from 
a back copy and retry. 

None. 



Correct the RC 
directive to ASLABEL. 



Wait until processing is 
complete before entering 
commands other than END. 



ASUSE 



ASVAL 



ASDEBUG 



ASLABEL 



SCRSIM 



DAF BUSY filenam userin. 



DAF ZERO LENGTH filenam userin. 



DATA BASE ERROR. 



Direct access file filenam with user index 
userin cannot be dumped because it is 
attached in WRITE mode; file is skipped. 
This is a nonfatal system error. 

Direct access file filenam with user index 
userin was empty and therefore could not be 
dumped; file is skipped. This is a nonfatal 
system error. 

Dayfile message indicating that the system 
has detected an error in its validation 
file. 



Retry PFDUMP operation 
after user has released 
the file. 



None. 



Contact installation 
personnel. 



PFDUMP 



PFDUMP 



CHARGE 
MODVAL 



DATA BASE ERROR n - NOTIFY ANALYST. 



DATA BASE NAME FIRST CHARACTER BAD. 



DATA BASE NAME NOT 2 CHARACTERS. 



DATA FILE FORMAT ERROR. 



System error dayfile message indicating that 
an abnormal situation exists, n is dis- 
played for consideration by the analyst. 
The internal documentation, obtained by 
using the DOCMENT control statement, con- 
tains an explanation of each error n for 
use by the analyst. (Refer to section 7 in 
volume 1 of the NOS Reference Manual for a 
description of DOCMENT.) 

Output file message indicating that the 
first character of the transaction subsystem 
data base name is. not alphanumeric. 

Output file message indicating that the 
transaction subsystem data base name is hot 
two characters in length. 

The specified data file does not conform to 
the format expected. 



Inform site analyst. 



PROFILE 



Correct and rerun. 



Correct and rerun. 



Make sure the correct 
data file format has 
been specified on the 
control statement. 



VALNET 



VALNET 



ACPD 
PROBE 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



DATA LINE TOO LONG. 



Nonfatal K-display message indicating that 
too many characters are in the data line. 



Shorten the line. 



STIMULA 



DATA LOST IAFEX tn. 



IAF could not accept input from terminal tn 
because a driver reentry was waiting to be 
processed. The input data is lost. 



Inform site analyst • 



IAFEX 



DAYFILE BUSY. 



The dayfile to be terminated is currently 
attached to another job. 



Retry operation. 



DFTERM 



DAYFILE STATUS INDEFINITE. 



An error exit occurred which caused DFTERM 
to abort while it was terminating a dayfile. 
Status of the dayfile is unknown. 



Inform site analyst 
immediately. 



DFTERM 



DAYFILE TERMINATED. 



Informative message issued to the terminated 
dayfile. 



None. 



SFM 



DEADS TART FILE FORMAT ERROR, 



An error was detected in the directory of 
the deadstart file. 



Check the contents and 
format of the deadstart 
file for errors. 



INSTALL 



****DELETE NON-EXISTENT USER NUMBER. 



DELETING usernum. 



Output file message indicating that the user 
number to be deleted from the specified 
charge/project number entry does not exist. 
This message is not posted on the K display 
(DUN directive is ignored) and is not listed 
on the output file until all directives for 
the specified charge/project number have 
been processed. 

Message displayed at line 1 of control 
point indicating that the user number 
usernum is being deleted. 



Check the user number 
and retry. 



PROFILE 



None. 



MODVAL 



DESTINATION DEVICE ERROR. 



An unrecoverable error occurred while QLGAD 
was writing to the destination device. 



Check the output file 
for the files that 
were processed. 
Reload to different 
device. 



OLOAD 



DESTINATION DEVICE REQUIRED. 



DESTINATION FAMILY NOT SPECIFIED. 



An attempt was made to load inactive queues 
but the destination device was not selected 
correctly. Either the family and device 
number or the pack name of the destination 
device must be specified. 

K-display message indicating that a GO 
command has been entered before the 
destination family (DF) or family name (FM) 
has been specified. 



Enter correct parameters 
and retry load 
operation. 



Enter the family name 
and type GO. 



QLOAD 



QFSP 



O 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



DETECTED IN CLD. 



O 



Error was encountered during the building of 
the system library. Disk resident overlay 
(OVL) or absolute (ABS) program is not 
formatted correctly. Deadstart processing 
halts when this error is detected. 



Redeadstart at a 
different tape density 
or use another tape unit 
or a different deadstart 
tape. If the error 
persists, inform the 
site analyst. 



SYSEDIT 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



W 



DETECTED IN DIRECTORY. 



DETECTED IN PLD. 



DETECTED IN RCL. 



DETECTED IN RPL. 



DEVICE ERROR. 



System file error occurred during the 
building of the system library. Start of 
the system library was not found. Deadstart 
processing halts when this error is 
detected. 



System file error occurred during the 
building of the system library. Disk 
resident PP program or central memory 
resident PP program is not formatted 
correctly. Deadstart processing halts when 
this error is detected. 



Error was encountered during the building of 
the system library. Central memory resident 
overlay (OVL) or absolute (ABS) program is 
not formatted correctly. Deadstart 
processing halts when this error is 
detected. 



Error was encountered during the building of 
the system library. Central memory resident 
overlay (OVL) or absolute (ABS) program is 
not formatted correctly. Deadstart 
processing halts when this error is 
detected. 



The device number specified for a device 
to be cataloged refers to a nonmaster 
device. 



Redeadstart at a SYSEDIT 

different tape density 

or use another tape unit 

or a different deadstart 

tape. If the error 

persists, inform the 

site analyst. 

Redeadstart at a SYSEDIT 

different tape density 

or use another tape unit 

or a different deadstart 

tape. If the error 

persists, inform the 

site analyst. 

Redeadstart at a SYSEDIT 

different tape density 

or use another tape 

unit or a different 

deadstart tape. If the 

error persists, inform 

the site analyst. 

Redeadstart at a SYSEDIT 

different tape density 

or use another tape 

unit or a different 

deadstart tape. If the 

error persists, inform 

the site analyst. 

Specify master device and PFCAT 
retry operation. 



DEVICE FULL FOR COMMUNICATION FILE. 



DEVICE NOT FOUND. 



A disk full condition does not allow file 
MOVCOM to be written. 

Device number (DN) specifed to be 
cataloged was not defined in the system. 



Manually free disk 
space and rerun ASMOVE. 

Retry operation with 
device defined in the 
system. 



ASMOVE 



PFCAT 



DEVICE UNAVAILABLE. 



The sum of the device masks in the family is 
less than 377B. The user tried to write a 
permanent file, but his user index does not 
reference a device in the family. 



Contact site analyst. 



PFM 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



DFD - message. 
DFTERM ABORTED. 



Refer to explanation of AFD - message. 
An error exit caused DFTERM to abort. 



Check the dayfile 
for more information. 



DAYFILE 
DFTERM 



DIRECTIVE ERRORS. 



Dayfile message indicating that one or more 
input directives were in error. Fatal error. 



Examine output file to 
determine reason for 
error. 



MODIFY, 

OPLEDIT, 

LIBTASK, 

MODVAL, 

PROFILE, 

SYSEDIT 



****DIRECTIVE NOT AUTHORIZED. 



DIRECTIVE NOT MEANINGFUL. 



DIRECTIVE PARAMETER ERROR. 



DIRECTIVE RESTRICTED TO PRINTER OUTPUT. 



DIRECTIVE RESTRICTED TO TERMINAL OUTPUT, 



Output file message indicating that the user 
must be either a special accounting user or 
from system origin to issue this directive. 

The MPP or PMS directive for the DSDI 
control statement has no meaning for this 
dump. 

Output file message indicating that an error 
was detected in a directive parameter. 

Output file message indicating that the 
directive entered produces output which 
cannot be listed at a terminal. 



Output file message indicating that the 
directive entered produces output which must 
be listed at a terminal. 



None. 



Remove the meaningless 
directive. 



Correct and rerun. 



Assign the output to an 
alternate output file 
for later printing at a 
line printer (refer to 
the description of the 
OUTPUT directive) . 

Use directive from 
terminal. 



PROFILE 



DSDI 



DSDI 



DSDI 



DSDI 



DIRECTORY TABLE BAD. 



DISK FILE ERROR. 



Dayfile message indicating that an EOR or 
EOF was encountered while the random file 
directory which was created by the D option 
was being read. 

MSSEXEC encountered a write error on a file. 



Ensure that the dump 
file contains meaningful 
information. 



Retry using a different 
file name. 



DSDI 



ASDEBUG 



DISK FULL. 

STAGING DELAY, FM-faraily, Ul-userin. 

DNdn FM family FNT FULL. 



Staging is delayed because of insufficient 
disk space. 

The FNT was filled while recovering the 
specified device. 

dn Device number 

family Family name 



Use ASMOVE to free up 
disk space. 

Retry at a later time 
when the system is 
not as busy. 



EXSTGE 



QREC 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



DNdn, FM family IGNORED - ERROR IDLE. 



tu 



Informative message indiating that queues 
on the specified device were not processed 
because the device had an error idle status. 



None. 



QREC 



DNdn FM family IGNORED - REMOVABLE. 



DNdn FM family IGNORED - SHARED. 



DNdn FM family IQFT INTERLOCKED. 



DNdn FM family MS ERROR. 



DNdn FM family NO IQFT FILE. 



DNdn FM family UNDEFINED ERROR. 



DSD I ARGUMENT ERROR. 



Informative message indicating that queues 
on the specified device were not processed 
because the device is removable. 

dn Device number 

family Family name 

Informative message indicating that queues 
on the specified device were not processed 
because the device is shared and QPROTECT 
is disabled. 

dn Device number 

family Family name 

The track interlock on the IQFT file is 
set. It is possible IQFT is currently 
being used by another utility. 

dn Device number 

family Family name 

A mass storage error occurred while 
processing the IQFT file on the specified 
device. 

dn Device number 

family Family name 

Informative message indicating that no IQFT 
file exists for the specified device. 

dn Device number 

family Family name 

System failure has occurred generating an 
erroneous error code. 

dn Device number 

family Family name 

Dayfile message indicating that an unknown 
keyword was encountered on the DSD I control 
statement. 



None. 



None. 



QREC 



QREC 



Retry at a later time. 



Inform site analyst. 



None. 



Inform site analyst. 



Correct and rerun. 



QREC 



QREC 



QREC 



QREC 



DSD I 



DSD I ERROR LIMIT EXCEEDED. 



Dayfile message indicating that more than 50 
errors were detected. 



Examine output file for 
specific errors. 



DSD I 



DSFB USED - n. 



Informative message indicating that the 
destage for backup value used by ASMOVE is 



None. 



ASMOVE 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



DUMP FILE dnum NOT IN SYSTEM. 



DUMPING filenam userin. 



NDA turned off the dump index entry for dump None, 
number dnum because the dump does not exist 
in the system. NDA continues. 

Informative message indicating the name of None, 
the file being dumped and the user index 
under which the file is stored. 



NDA 



PFDUMP 



DUMPING - DIRECT ACCESS FILES ONLY. 



Informative message indicating that only 
direct access files have been selected to 
be dumped (OP*D option specified) . 



None. 



PFDUMP 



DUMPING - INDIRECT ACCESS FILES ONLY. 



****DUPLICATE CHARGE NUMBER. 



**DUPLICATE CS PARAMETER. 



DUPLICATE FILE NAME. 



Informative message indicating that only 
indirect access files have been selected 
to be dumped (OP=«I option specified). 

Output file message indicating that an 
existing charge number was referenced on a 
create run. 

The same CSU is indicated more than once on 
the CS parameter. 

Dayfile message indicating that when QFM 
tried to attach an inactive queue file to 
the control point, a file by the same name 
was already assigned. 



None. 



Rerun using correct 
charge number, if 
required. 

Correct the CS parameter. 



Rename, or return the 
file with the 
conflicting name. 



PFDUMP 



PROFILE 



ASVAL 



QFM 



DUPLICATE FILE NAME ERROR. 



The files for input and output have the same 
name. 



Change and retry. 



PROBE 



****DUPLICATE PROJECT NUMBER. 



**DUPLICATE SB PARAMETER. 



DUPLICATE USER NUMBER. 



Output file message indicating that an 
existing project number was referenced on a 
create run. 

The same subfamily is indicated more than 
once on the SB parameter. 

Output file message indicating that the 
user number encountered on a create run is 
a duplicate of a user number previously 
entered. The first entry is used. 



Rerun using correct 
project number, if 
required. 

Correct the SB parameter. 



Rerun the corrected job 
or correct the new 
validation file, if 
necessary. 



PROFILE 



ASVAL 



MODVAL 



****DUPLICATE USER NUMBER. 



O 



ECS RECORD NOT FOUND. 



The user number to be added already exists 
for the specified charge/project number 
entry. This message is not posted on the 
K display (AUN directive is ignored) and is 
not listed on the output file until all 
directives for the specified charge/project 
number have been processed. 

Output file message indicating that the ECS 
record was not found in the EDD file. 



Choose a different user 
number. 



PROFILE 



Ensure that the dump file 
contains meaningful 
information. 



DSD I 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



O 



ELD - message. 
EMPTY CATALOG. 

EMPTY SESSION FILE. 



Refer to explanation of AFD - message. 
No entries are present in the catalog. 



Nonfatal K-display message indicating that 
the session file was empty. 



None. 



Resupply the correct 
file name, or put data 
into the file. 



CATLIST 
NDA 



STIMULA 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



END OF COPY. 



Informative message indicating that the copy 
is complete. 



None. 



PFCOPY 



END OF DUMP FILE ENCOUNTERED WHILE 
SEARCHING FOR RECORD x. 



Attempts to read record type x into memory 
have encountered an end-of-file condition 
indicating that the dump file is missing 
the record. 



Correct error and 
try again. 



NDA 



END SIMULATOR. 



Dayfile message indicating that the operator 
has entered STOP, to drop the simulator. 



None. 



SCRSIM 



ENTER E TO TERMINATE LOADING. 

L TO LIST REMAINING FILES. 

GO TO RESUME INCREMENTAL LOAD. 



ENTERED PARAMETER IS ILLEGAL. 



This message occurs as a result of a 
complete load of an archive file during 
incremental load operations. The message 
appears at the end of a reel during 
incremental loading to allow the operator 
to optionally load additional reels. 

Parameter is not in legal format. 



Enter E, L, or GO as 
indicated in the 
message. 



Check dayfile for more 
detail on error. Enter 
correct parameter via 
the K display. 



PFLOAD 



PFS 



EOI BAD ON ATTACHED FILE. 



EQeq ,DNdn .message . 



EQ/xx TRACK LIMIT. 



EQUIPMENT NUMBER OUT OF RANGE. 



The EOI sector cannot be found on the 
specified file. 

A permanent file utility has encountered an 
error on equipment eq, device dn. 



Mass storage device with EST ordinal xx has 
no allocatable tracks left and a program is 
waiting for a track in order to continue 
processing of a file. Additional space must 
be made available on the device. Error log 
message for PFM; dayfile message for PFU. 

Output file message indicating that the 
equipment number specified is not between 
and 100B. 



Inform site analyst. 



Refer to the explanation 
given for the message 
following the device 
number for further 
information. 

Inform site analyst. 



Correct and rerun. 



QFM 



PFDUMP, 
PFLOAD 



PFM, 
PFU 



VALNET 



ERROR FILE LIMIT. 



ERROR FLAG NOT SET IN CSUMAP. 



ERROR IN lib deck. 



One of the following. 

- An unrecoverable error occurred during 
an attempt to create the error file. 

- The number of error files created has 
exceeded the upper limit allowed. 

The RC directive to ASDEBUG did not remove 
the CSU map entry because the error flag 
was not set in the CSU map entry. 

An error was detected in the specified 
libdeck while processing the SYSEDIT 
command. 



Check the output file 
for files processed. 
Retry load skipping 
files in error. 



Correct the CS, XI, and 
YI parameters and retry. 

Correct the error in 
the libdeck and retry. 



QLOAD 



ASDEBUG 



SYSEDIT 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



ERROR IN ALPHABETIC DATA. 



****ERROR IN ALPHANUMERIC DATA. 



ERROR IN DATE. 



ERROR IN DEVICE NUMBER. 



ERROR IN FAMILY NAME. 



ERROR IN FILE SIZE RANGE. 



K-display message indicating that either no 
data is present or an illegal separator 
follows the data. 

Output file message indicating any of the 
following. 

- No data was present. 

- The data accompanying the *AW* input 
identifier was unrecognizable. 

- The number of characters exceeded the 
maximum allowed. 

If entered from the K display, the line of 
input on which the error occurred is 
disregarded; otherwise, that particular 
user number is disregarded. 

K-display message indicating any of the 
following. 

- The date entry is not in the correct 
format. 

- An illegal separator follows the date. 

- The date entry is prior to 70/01 /01 . 

- The date entry is not a valid date 
(e.g. 76/04/44). 

K-display message indicating one of the 
following. 

- No family name has been specified. 

- The device number is not in the speci- 
fied family. 

- An illegal separator follows the device 
number. 

K-display message indicating that either the 
specified family cannot be found or an 
illegal separator follows the family name. 

K-display messge indicating one of the 
following. 

- File size is nonnumeric. 

- File size range is not within the range 
(or min) through 77777B (or max) 
where min is the minumum file size and 
max is the maximum file size. 

- An illegal separator follows the last 
size. 



Correct and reenter K- 
display input. 

Rerun the corrected job 
or correct the new 
validation file, if 
necessary. 



QFSP 



MODVAL 



Correct and reenter K- 
display input. 



QFSP 



Correct and reenter K- 
display input • 



QFSP 



Correct and reenter Re- 
display input. 



Correct and reenter K- 
di splay input. 



QFSP 



QFSP 



ERROR IN IAFEX ARGUMENTS. 



An error was encountered on the IAFEX 
control statement. 



Correct error and retry. 



IAFEX 



W 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



ERROR IN IAFEX PARAMETER - T. 



ERROR IN ID RANGE. 



ERROR IN IDENTIFIER. 



****ERROR IN IDENTIFIER. 



ERROR IN LIMITS ARGUMENT. 



ERROR IN MODVAL ARGUMENTS. 



ERROR IN NUMERIC DATA. 



****ERROR IN NUMERIC DATA. 



The value assigned to the T parameter on the 
IAFEX control statement Is not valid. 

K-display message indicating one of the 
following. 

- ID is not within the range through 
77B. 

- Illegal separator between or after ID 
data. 

- Minimum ID is greater than the maximum 
ID. 

- Identifier number is nonnumeric 

K-display message indicating that an illegal 
directive or command has been entered, or a 
directive is illegal for the selected 
utility. 

Output file message indicating that an 
illegal parameter identifier was encountered. 
If entered from the K display, that line of 
input is disregarded; otherwise, that 
particular user number is disregarded. 

Dayfile message indicating that parameters 
were included on the LIMITS statement. 

Dayfile message indicating that invalid 
control statement arguments were entered. 

K-display message indicating one of the 
following. 

- No data is present. 

- Nonnumeric data was entered where 
numeric data was required. 

- Numeric data exceeds maximum value. 

Output file message indicating any of the 
following. 

- The data was nonnumeric and numeric 
data was required 

- Numeric data exceeded the maximum 
allowed 

- No data was present 

If entered from the K display, the line of 
input on which the error occurred is 
disregarded; otherwise, that particular 
user number is disregarded. 



Correct T parameter and 
retry. 

Correct and reenter K- 
display input. 



Correct and reenter K- 
display input. 



Rerun the corrected job 
or correct the new 
validation file, if 
necessary. 



Enter LIMITS, without 
additional parameters. 

Specify the correct 
arguments and rerun. 

Correct and reenter K- 
display input. 



Rerun the corrected job. 
Correct the new 
validation file, if 
necessary. 



IAFEX 



QFSP 



QFSP 



MODVAL 



MODVAL 



MODVAL 



QFSP 



MODVAL 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



ERROR IN PARAMETERS. 



ERROR IN PROFILE ARGUMENTS. 



ERROR IN SELECTED FILE TYPE. 



ERROR IN STIMULATOR ARGUMENTS. 



ERROR IN USER INDEX RANGE. 



****ERROR IN USER NUMBER. 

ERROR LOG DUMPED. 

ERROR ON FILE - PROFILa. 

ERROR ON OUTPUT FILE. 

ERROR READING THE PFC. 

ERRORED FILE PARTIALLY DUMPED - filenam. 



There is an error in the channel parameter 
(C-cc) on the LOADBC control statement. 

Dayfile message indicating there was an 
error on the PROFILE control statement. 

K-display message indicating that either 
the file type selected cannot be recognized 
or an illegal separator follows the file 
type. 

Fatal dayfile message indicating that a 
parameter other than the I parameter is 
present, or the parameter is in the wrong 
format. 

K-display message indicating one of the 
following. 

- User index is nonnumeric data. 

- User index is not within the range 
(or min) through 377777B (or max) 
where min is the minimum user index 
and max is the maximum user index. 

- An illegal separator follows the last 
user index. 

Output file message indicating that illegal 
data was encountered where the user number 
was expected. MODVAL disregards the 
illegal data and goes to the next user 
entry. 

The error log dump is complete. 

Either the profile file cannot be found or 
there is a bad profile file level-3 block 
random address. 

K-display message indicating that the OUT 
command was entered when no output file 
existed. 

The PFC entries for the family are either 
missing or have a bad sector error. 

Informative message indicating that an 
unrecoverable read error was encountered 
on file filenam while the option to dump 
files in error was disabled. The back- 
space on the dump file hit the beginning 
of the tape reel, leaving filenam partially 
dumped on the previous reel. This file 
will not be loaded if the option to load 



Correct the parameter 
and retry. 

Correct the control 
statement and rerun. 

Correct and reenter K- 
display input. 



Correct and rerun. 



Correct and reenter K- 
display input. 



LOADBC 



PROFILE 



QFSP 



STIMULA 



QFSP 



Rerun the job or correct 
the new validation file, 
if necessary. 



None. 

Inform site analyst. 

None. 



Reload the permanent 
files. 

None. 



MODVAL 

DAYFILE 
CPM 

QREC 

ASVAL 
QDUMP 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



files in error is disabled. 



Q 



ERRORED TRACK NAME LIMIT. 



EXCESSIVE PARITY ERRORS. 



1000 files of the type ERRxxx (error files) 
already exist. 

xxx Sequence number from 001 through 999 

Excessive recovered parity errors due to a 
faulty MST or cartridge were encountered 
while the cartridge label was being 
written. 



Inform site analyst 
immediately. 



Retry after cleaning or 
repairing the MST, or 
discard the cartridge. 



QM0VE 



ASLABEL 



EXCESSIVE WRITE ERRORS. 
DESTAGE RESTARTED. 



EXEC ABNORMAL, xxx. 



EXEC ABORT - SYNTAX ERRORS. 



EXEC IN SINGLE MAINFRAME MODE. 



EXEC MMF INITIALIZATION FAILED 
- message. 



A file destage operation was restarted 
using different cartridges because excessive 
write errors were encountered. 



There is an internal error in module xxx of 
MSSEXEC. 

The MSSEXEC control statement is 
syntactically incorrect. 

Informative message indicating that MSSEXEC 
is running in a single mainframe environment. 

MSSEXEC failed to establish communication 
with any of the slave machines in a 
multimainframe environment; message 
indicates the reason and can be one of the 
following. 

ALL SLAVES OMITTED 

ATTACH MTOS FAILED 

DEFINE MTOS FAILED 

MTOS FILE BUSY 

SETPFP PROBLEM 



Run ASVAL to identify 
the problem cartridges 
and any permanent files 
on these cartridges. 
Remove the files from 
the cartriges (refer to 
Error Conditions and 
Corrective Action in 
section 3) . 

Inform site analyst. 



Correct errors and retry. 



EXDEST 



None. 



Submit a Programming 
System Report (PSR) with 
supporting material. 
Analyze error and try 
again. Ensure that 
the link device is 
configured as a direct 
access permanent file 
device. 



MSSEXEC 



MSSEXEC 



MSSEXEC 



MSSEXEC 



EXEC MMF INITIALIZATION OK. 



Informative message indicating that MSSEXEC 
is ready to run in a multimainframe 
environment. 



None. 



MSSEXEC 



EXEC - SLAVE i xxxx. 



Informative message indicating that MSSEXEC 
is ready to communicate with MSSSLV on 
mainframe i or that the status of MSSSLV on 
mainframe i has changed. The current status 
of MSSSLV is indicated by xxxx and can be 
IDLE, ACTIVE, or INACTIVE. 



None. 



MSSEXEC 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



EXEC - SLAVE i OMITTED - 
- message. 



EXEC SMFMODE - ALL SLAVES OMITTED. 



EXEC STATISTICS. 



MSSEXEC was .unable to establish or maintain 
access to a communication file with MSSSLV 
on mainframe i; message indicates the reason 
and can be one of the following. 

NO STOM FILE 

STOM FILE ERROR 

STOM FILE LENGTH PROBLEM 
MSSEXEC will continue to operate, but will 
not attempt to receive requests from MSSSLV 
on mainframe i. 



MSSEXEC has lost access to all of the 
MSSSLVs and is now running in single 
mainframe mode. 

The values following this message are used 
for internal maintenance and tuning only. 
Refer to EXEC program listings if further 
information is needed. 



If MSSSLV is to be run 
on mainframe i, and the 
message is NO STOM FILE 
or STOM FILE ERROR: 
idle MSSEXEC, purge the 
STOM file, initiate 
MSSSLV, and initiate 
MSSEXEC. If the message 
is STOM FILE LENGTH 
PROBLEM, then purge the 
existing STOM file, and 
reinstall MSSEXEC and 
MSSSLV using identical 
values for NUMRB, 
MAXSLV, and NUMSLV in 
common deck COMEIPR and 
for RBSIZE in common 
deck COMAMSS. 

Inform site analyst. 



None. 



MSSEXEC 



MSSEXEC 



NS 
CS 



EXPECTING MEMORY RESIDENT BUT READING 
OVERLAY AREA HEADER. 

EXPECTING OVERLAY BUT READING MEMORY 
RESIDENT HEADER. 

EXPRESS DUMP COMPLETE (FL USED xxxxxxB) 



FAMILY FILES ACTIVE. 



FAMILY NAME MUST BE ENTERED. 



The type of record being read conflicts 
with the file description card. 

The type of record being read conflicts 
with the file description card. 

Dayfile message indicating that the dump was 
completed normally. The amount of field 
length used was xxxxxx octal words. 

Dayfile message indicating that the direct 
access file count is greater than the number 
of fast attach files. 



K-display message indicating that the 
operator attempted to enter a specific 
device number before entering a specific 
family name. 



Eliminate conflict and 
try again. 

Eliminate conflict and 
try again. 

None. 



Use IDLEFAMILY, and wait 
for direct access file 
count to decrease until 
it equals the number of 
fast attach files. 

Enter the missing family 
name and type GO. 



LFG 



LFG 



DSDI 



ISF 



QFSP 



a 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



O 



FAMILY NOT FOUND. 



FAMILY NOT FOUND IN SYSTEM. 



FAMILY /PACK NOT FOUND. 



The family specified by the FM parameter 
on the ASLABEL, ASMOVE, ASUSE, or ASDEBUG 
control statement does not exist or is not 
on line. 

The family specified by the FM parameter on 
the ASVAL control statement or the family in 
the RDF header was not found in the system 
family packs. 

Family or pack specified is not defined in 
the permanent file system. 



Specify an existing 
on-line family and 
retry. 



Correct the parameter or 
add the family to the 
system. 



Reenter parameters and 
specify correct pack or 
family name, or enter 
(mount) the correct 
family or pack into the 
system if not currently 
present. 



ASMOVE 
ASLABEL 
ASDEBUG 
ASUSE 

ASVAL 



PFS 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



FAST ATTACH FILES ON DEVICE. 



FAST-ATTACH PROFILE FILE ILLEGAL. 



FCT ORDINAL OUT OF RANGE. 



An attempt was made to initialize a mass 
storage device on which one or more fast- 
attach files are currently active. This 
message also appears in the comment field 
of the system control point in the job 
status (B) display. 



Dayfile message indicating that the project 
file cannot be in fast-attach status on a 
reformat run. 



The FCT ordinal specified by the FO 
parameter in a directive to ASDEBUG is out 
of range. 



Inform site analyst; the IDS 
fast-attach files will 
have to be released, via 
ISF function, before the 
device can be initial- 
ized. The recommended 
procedure is as follows. 

- Examine the FNT (H) 
display to determine 
the names of the 
fast-attach files on 
the device (typical- 
ly, VALIDUZ, 
PROFILB, or RSXDid) . 

- Release those files 
via ISF entries 

in the following 

format. 

X.ISF,R=filenam. 
If fast-attach files are 
to be reloaded after the 
device is initialized, 
those files must be 
initialized via the 
entry X.ISF. 

Use the ISF control PROFILE 

statement with the R 
option to release the 
project file from fast- 
attach status. 

Correct the FO ASDEBUG 

parameter and retry. 



FDP ABORT - USER VALIDATION ERROR. 



FETCHING FLAW DATA S/N-serialn. 



Dayfile message indicating that ENGINEERING 
mode has not been set at the system console. 

Console message indicating that the factory 
recorded data is being retrieved from 
cylinder 6328 (or 1466B), track 0, sectors 
0, 1, and 2. Here, serialn is the actual 
pack serial number read. 



Set ENGINEERING mode at 
the system console. 

None. 



FDP 



FORMAT 



FILE ALREADY DE STAGED. 
DE STAGE ABANDONED. 



A file destage operation was abandoned 
because the file already had been destaged. 



None. 



EXDEST 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



FILE ALREADY INTERLOCKED. 



FILE DESCRIPTION CARD TERMINATES WITHOUT A 
PERIOD. 

FILE EQUIVALENCE MAY NOT BE 0. 



FILE ERROR. 



FILE NAME CONFLICT. 



FILE NAME CONFLICT. 



FILE NAME CONFLICT. 



FILE NAME CONFLICT. 



FILE NAME CONFLICT - FILE filenam. 



FILE NAME ERROR — filenam. 



FILE NAME NOT SET. 



FILE NOT FOUND. 



The track interlock for an IQFT file is 
currently interlocked. 

The user failed to terminate a file 
description card with a period. 

Dayfile message indicating that either the 
input of the standard output file has been 
declared empty (that is, set equal to 0). 

K-display message indicating that the 
change file specified could not be attached. 



Dayfile message indicating that the file 
name specified with the P option (terminal 
network description) is the same as the file 
specified with the L option (error listing). 

The file names specified by the I and L 
directives are identical or a reserved file 
name was specified. Reserved file names 
include IQF, MIQFT, NIQFT, and SCR. 

The file to receive output cannot be named 
IQF or NIQFT. 

The names of the output, load, and IQFT 
files conflict. 



The names of the output, dump, and IQFT 
files conflict. 



The name of the file (filenam) on the file 
description card is greater than seven 
characters or begins with a number. The 
scan continues after the next period. 

Nonfatal K-display message indicating that 
a GO was entered, and the file name was not 
set. 

Requested file could not be found. 



Inform site analyst. 



Correct error. 



Correct and rerun. 



Verify that the change 
file is an indirect 
file. 

Specify unique file 
names with the P and L 
options. 



Change the incorrect 
file name(s) and reenter 
directives (s) . 



Change output file name 
and enter new directive. 

Change the name of the 
output or load file and 
retry the operation. 

Change the name of the 

output or dump file 

and retry the operation. 

Correct error. 



Set the file name. 



Verify that file exists 
and retry. 



QFM 
LFG 
FORMAT 

STIMULA 

VALNET 

QFSP 

QREC 
QLOAD 

QDUMP 

LFG 

STIMULA 



LFM, 

SFM, 

QFM, 

ENQUIRE, 

STIMULA 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



W 



FILE POSITION LOST — NOT ENOUGH MEMORY 
IMAGE RECORDS. 



TAPRO indicates that memory image records 
ended before the count reached zero, 
suggesting a bad LINK-EDIT file. 



Check LINK-EDIT file. 



LFG 



FILE READ ERROR. 
DESTAGE ABANDONED. 



A file destage operation was abandoned 
because of a disk read error. 



Investigate cause of 
disk error and take 
appropriate corrective 
action. 



EXDEST 



FILE TRUNCATED filenam userin. 



FILE WRITE ERROR. 

STAGING DELAY, FM-family, Ul-userin. 



Data for file on archive tape is shorter 
than the length indicated in the catalog 
entry for the file. The file is truncated 
and the length in the catalog is updated 
to reflect the smaller size. This is a 
nonfatal system error. 

Staging is delayed because of a file write 
error. The staging will resume 
automatically and will either complete 
successfully or encounter the same file 
write error. 



Load the file from a 
backup tape if 
desired. 



Investigate cause of 
disk error and take 
appropriate corrective 
action. 



PFLOAD 



EXSTGE 



FILENAME CONFLICT - filenam. 



FILENAME filenam USER INDEX userin. 



File filenam was used for more than one 
purpose. 

Informative message indicating that only 
the specified file for the specified user 
index will be loaded (or dumped) . 



Correct call parameters 
and try again . 

None. 



MODVAL 



PFLOAD, 
PFDUMP 



FINAL PF SPACE - n. 



Informative message indicating that the 
permanent file space at the end of the 
ASMOVE run is n PRUs. 



None. 



ASMOVE 



FM NOT LEGAL FAMILY. 



Dayfile message indicating that an illegal 
family name was specified with the FM 
parameter. 



Correct the FM parameter 
and rerun. 



PROFILE, 
MODVAL 



*FNT* FULL DETECTED BY *VEJ*. 



When called to assign a file to mass 
storage, VEJ returned status indicating 
that the FNT was full. 



Check output file to 
determine which files 
were not loaded. Retry 
when system is not as 
busy. 



QLOAD 



FNT IS FULL. 



The FNT became full during processing of the 
requeue function and all files could not be 
requeued. 



Inform site analyst. 



QFM 



*FNT* LIMIT ON LOAD. 



The calculated FNT threshold has been 
reached . 



Check listing to 
determine which files 
were not loaded. Retry 
when the system is not 



QLOAD 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



FNT THRESHOLD LIMIT. 



FNTLIST/QALTER ABORTED. 

FO NOT SPECIFIED CORRECTLY. 

FORMAT ERROR xxxx. 



FORMAT ERROR. 



FORMAT ERROR IN TIME PARAMETER. 



FREE FILES NOT RELEASED. 



The FNT threshold for the number of queue, 
non-TXOT rollout, fast-attach, and system 
files allowed in the FNT has been reached. 
No more queued files can be activated 
until some of these files are released. 

The system aborted FNTLIST or QALTER. 

The FO parameter was specified without an 
equals sign in a directive to ASDEBUG. 

Dayfile message indicating that a channel 
malfunction has occurred, causing FDP to 
abort the control point. 

xxxx One of the following malfunctions. 



0001 



0004 



0010 



0014 



0015 



0024 



0026 
0027 

0032 



The coupler was reserved 

from the opposite access. 

The disk drive was hung 

busy. 

An uncorrectable error has 

occurred 

Status was expected, but 

none was received. 

An uncorrectable error on 

the channel connection 

occurred. 

An output failure occurred 

on the FORMAT parameter 

array. 

A read abort occurred. 

A detailed status abort 

occurred. 

An uncorrectable error 

occurred during 

formatting. 



K-display message indicating that an error 
exists in the syntax of the command or the 
values of the parameters. 

The values specified for the loop operation 
times do not conform to standard numeric 
format (digits 0-9 with optional post-radix 
D or B) . Default base is decimal. 

Informative message indicating that ASVAL 
did not release the MSF space allocated to 
trouble-free orphans, because the last 
release date was after the last RDF dump 
date. 



as busy. 

Retry when system is not 
as busy. 



Contact site analyst. 

Specify FO correctly 
and try again. 

Correct and rerun. 



QREC 
0M0VE 



FNTLIST 
ASDEBUG 

FDP 



Correct the command or 
parameters and retry 
operation. 

Correct and retry. 



Retry with the correct 
RDF file. 



TAF 

PFLOAD 

STIMULA 

ICPD 



ASVAL 



O 



o 



MESSAGE 
FREE FILES RELEASED. 



FROZEN CHAIN. 



FUNCTION TIMED OUT - nnnn. 



GENERAL STATUS = nnnn. 



GENERATING CATALOG IMAGE, 



GENLAB - ABNORMAL TERMINATION. 



HARDWARE PROBLEM. 
DE STAGE RESTARTED. 

HARDWARE PROBLEM. 

filenam FOR jobnara NOT STAGED. 



HARDWARE REGISTERS NOT FOUND. 



HEAD MOTION ERROR. 
DESTAGE RESTARTED. 

HEADER NOT 30 WORDS OR TAPE POSITION LOST. 



HFM ERROR ec 



SIGNIFICANCE 

Informative message indicating that ASVAL 
released the MSF space allocated to trouble- 
free orphans. 

While trying to read a file, ASDEBUG 
encountered the frozen chain flag set in 
the stream chain. 



1LC timed out in the function routine while 
accessing the controller, 
nnnn Function code 

The controlware load was not successful and 
the general status of the controller (nnnn) 
is not zero. 

Informative message indicating that catalog 
image record (CIR) is currently being 
written to the archive file. 

The label from stream zero contains an 
illegal vsn. 

A file destage operation was restarted 
because of a hardware problem. 

The staging of file filenam for job jobnam 
was abandoned because an MSF hardware 
problem was detected. 

Output file message indicating that the 
hardware register record was not found in 
the EDD file. 

A file destage operation was restarted 
because of a hardware problem. 

TAPRO indicates that user probably forgot 
to skip a loader record, or that the LINK- 
EDIT file is bad. Header records must be 30 
16-bit or 8 60-bit words long. 

Dayfile message indicating that: a hardware 
function manager (HFM) error has occurred, 
ec Error code 

1 An HFM argument error has 
occurred. An illegal function 
code was encountered or a 
parameter-word address was out 
of range. 

2 An HFM illegal request has 



ACTION 



None. 



Run ASVAL to identify 
the problem streams on 
the chain, and then 
read each stream 
separately using the RS 
directive to ASDEBUG. 

Inform customer 
engineer. 



Inform customer 
engineer. 

None. 



Restore label with the 
FX directive to ASLABEL. 

Inform customer 
engineer. 

Call customer engineer. 



Ensure that the dump file 
contains meaningful 
information. 

Inform customer 
engineer. 

Correct error and 
try again. 



Examine a listing of HFM, 
which can be obtained by 
assembling HFM. 



ROUTINE 
ASVAL 



ASDEBUG 



LOADBC 



LOADBC 



PFDUMP 



ASLABEL 



EXDEST 



EXSTGE 



DSDI 



EXDEST 



LFG 



SCRSIM 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



I/O ON EXECUTE-ONLY FILE filenam. 



ICPD COMPLETE. 



ILLEGAL ACCOUNT /FAMILY. 



ILLEGAL APPLICATION ACCOUNTING REQUEST. 



ILLEGAL BIT NUMBER. 



ILLEGAL BYTE NUMBER. 



ILLEGAL CHARACTER. 



occurred. HFM was called from 
other than a special system 
job, auto recall was not set, 
or the user did not have system 
origin privileges. 
3 An illegal request for channel 
36 has occurred. In this case, 
channel 36 is not present. 

MODVAL cannot use an execute-only file as 
its input file. 

Informative message indicating system 
monitoring by CPD has been terminated. 

Dayfile message that may indicate that 
VALIDUs file is not present in the system or 
that the user has submitted an invalid user 
number or family name. 



The application program that issued this 
message attempted to initiate application 
accounting incorrectly. 

Dayfile message indicating that the bit 
number specified was greater than 203. 

Dayfile message indicating that the byte 
number specified was greater than 16. 

Dayfile message indicating that an alphabetic 
character other than B or D was entered as a 
postradix on a decimal value, an alphabetic 
character, 8, or 9 was entered in an octal 
value argument, or a character with a display 
code of 60B or above was entered. 



Change input file 
designation. 

None. 



Examine the EST (H,A.) 
display to determine if 
the VALIDUs file is 
active in the system 
(VALIDUs is a fast- 
attach file). If 
VALIDUs is active, no 
operator action is 
necessary; assume an 
illegal user number or 
family name was entered. 
However, if VALIDUs is 
not active, it must be 
initialized (activated) 
via the console entry 
X.ISF. 

Inform site analyst. 



Correct and reenter. 



Correct and reenter. 



Correct and reenter. 



MODVAL 



ICPD 



ACCFAM 



CPM 



SCRSIM 



SCRSIM 



SCRSIM 



ILLEGAL CHARGE. 



O 



Dayfile and output file message indicating 
one of the following. 

- The charge or project number does not 
exist. 

- The project number is not available to 



Check to see that charge 
and project numbers are 
correct and reenter. 



CHARGE 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



O 



a user with this user number. 

The charge or project number exists 

but is inactive. 



ILLEGAL COMMA AFTER SR — x. 



The skip record count x must be followed by 
a colon, semi-colon, or a period. The scan 
resumes at the next period. 



Correct error. 



LFG 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



ILLEGAL COMMAND. 



Dayfile message indicating that the command 
entered was not a legitimate SCRSIM command. 



Correct and reenter. 



SCRSIM 



ILLEGAL CONTROL CARD. 



ILLEGAL CONTROL POINT NUMBER. 



One of the following has occurred. 

- The control statement could not be 
identified. 

- The USER control statement does not 
have a user number specified. 

- An invalid parameter was specified or 
no terminator was detected. 

- The user included too many parameters 
on the program call statement or the 
program was not present. 

- The user submitted a control statement 
that he was not validated to use (for 
example, the use of PASSWOR by user not 
validated to change password) . 

- The user submitted a control statement 
that is illegal for a particular job 
type or file type (for example, the 
use of a FAMILY statement in a 
nonsystem origin job). 

Output file message indicating that either 
the control point number specified was 
greater than the number in the FDD file or 
the job name was not found. 



Ensure accuracy and/or 
suitability of control 
statement. 



Correct and rerun. 



TCS, 

CHARGE, 

CONFIG, 

MODVAL, 

RE SEX, 

EXU, 

PASSWOR, 

026 



DSD I 



ILLEGAL CSU. 



The CS parameter in a directive to ASDEBUG 
was not a letter from A through M. 



Correct the CS 
parameter and retry. 



ASDEBUG, 
ASUSE 



ILLEGAL CSU NUMBER. 



ILLEGAL D. 



ILLEGAL DATA. 



The CS parameter in a directive to ASLABEL 
was not a letter from A through M. 

The D parameter in a directive to ASDEBUG 
was not a number from through 7. 

Nonfatal K-display message indicating that 
the data contains an illegal display 
character. 



Correct the CS parameter ASLABEL 
and retry. 

Correct the D parameter ASDEBUG 
and retry. 

Correct the data and STIMULA 

rerun . 



ILLEGAL DELIMITER FOLLOWING filenam. 



A character other than a colon or 
semi-colon followed file filenam. 



Correct error. 



LFG 



****ILLEGAL DIRECTIVE. 



Output file message indicating one of the 
following. 

- The system encountered an 
unrecognizable identifier. 

An equal sign does not separate the 
identifier and a value. 

- The system encountered a DCN, DPN, or 



Rerun using correct 
directives. 



PROFILE 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



ILLEGAL DIRECTIVE. 



ILLEGAL DRAWER NUMBER. 



ILLEGAL DUMP REQUESTED. 



ILLEGAL ENTRY. 



ILLEGAL FAMILY NAME. 



ILLEGAL FILE NAME - filenam. 



ILLEGAL FILE NAME. 



ILLEGAL FILE NAME. 



ILLEGAL FILE NUMBER. 



ILLEGAL FUNCTION. 



ILLEGAL - L AND RF PARAMETERS. 



ILLEGAL LINE NUMBER. 



DUN directive when OP-C was specified. 

The directive specified is not a valid 
directive to ASLABEL or ASDEBUG. 

The D parameter in a directive to ASLABEL 
was not a number from through 7. 

One of the following conditions has been 
detected prior to a queue file dump. 

- The device specified to receive the 
dump is not a mass storage device. 

- The device specified to receive the 
dump is removable and the type 
specified is A (active) or ALL. 

K-display message indicating that the 
processor could not recognize the specified 
utility option. 

Dayfile message indicating that the family 
name specified in the ISF entry is not 
defined in the running system. 

Dayfile message indicating that a file has 
been given an illegal or duplicate name 
filenam. 

Dayfile message indicating that the file 
name specified in the ISF entry (file to be 
initialized) was not available to the system. 
Valid file names include VALIDUs, PROFILa, 
RSXDid, RSXVid, SYSPROC, and SYS JOB. 

Output file message indicating that an 
illegal file name was specified. 

Nonfatal K-display message indicating that 
the file number is greater than 18 bits. 

Illegal utility specified; PFS aborts. 



The files specified by the L and RF 
parameters on the ASVAL control statement 
are the same. 

Dayfile message indicating that the line 
number entered was not 0, 1, 2, or 3. 



Correct the directive 
and try again. 

Correct the D parameter 
and retry. 

Enter the correct param- 
eters and retry the 
operation. 



Correct and reenter K- 
display input. 



Repeat ISF entry with 
correct family name. 



Correct and rerun. 



Repeat the ISF entry with 
the correct file name. 



Correct and rerun. 



Reenter the correct 
decimal file number. 

Retry PFS entry with 
correct utility 
specified. 

Use a different file 
name for either the L or 
RF parameter. 

Correct and reenter. 



ASLABEL, 
ASDEBUG 

ASLABEL 



QDUMP 



QFSP, 

MSI, 

MREC 

ISF 



FORMAT 



ISF 



DSD I 



STIMULA 



PFS 



ASVAL 



SCRSIM 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



ILLEGAL MOVE REQUESTED. 



W 



ILLEGAL N. 



ILLEGAL NDA CALL PARAMETER p. 



****ILLEGAL NUMERIC VALUE. 



ILLEGAL OPTION. 



ILLEGAL PAGING ATTEMPT. 



ILLEGAL PASSWORD. 



****ILLEGAL PASSWORD IGNORED. 



One of the following. 

- Device specified is not mass storage. 

- Device specified is removable; the 
queue file type to be moved is 

A (active) or ALL. 

- Destination device is removable; 
destination disposition option is A 
(files remain active). 

- Destination device is a shared device, 
QPROTECT is disabled, and destination 
disposition option is I (files remain 
inactive) . 

The N parameter in a directive to ASLABEL 
was not a number from 1 through 2000. 

NDA aborted because call parameter p is 
illegal. 

Output file message indicating that the 
value specified by a directive does not 
convert to binary or is not within limits 
for the parameter specified. 

Nonfatal K-display message indicating that 
an illegal keyboard entry was made. 

K-display message indicating that the page 
advancing command (+) was entered before a 
LIST command or after a GO command. 

One of the following. 

- The password entered is greater than 
seven characters or contains an invalid 
character. 

- In the PASSWOR command either an 
incorrect old password was specified or 
the new password was unacceptable. 

- In the MODVAL control statement (for a 
create or update run) the password for a 
new user contained fewer characters than 
the minimum length required by the site. 
If entered from a K display, the line of 
input is ignored; otherwise, that par- 
ticular user number is disregarded. 

Output file message indicating that the 
password encountered during an update run 
was less than the minimum length required by 
the site. The update of the user number 
proceeds without the password change. 



Enter the correct 
parameters and retry move 
operation. 



QMOVE 



Correct the N parameter 
and retry. 

Correct parameter 
and call NDA again. 

Rerun using correct 
value . 



Reenter the correct 
option. 

None. 



Correct error and 
retry. 



ASLABEL 



NDA 



PROFILE 



STIMULA, 
MREC 

QREC, 
FNTLIST 



PASSWOR, 

MODVAL, 

PFILES 



Choose a correct 
password and update 
VALIDUs via PASSWOR or 
rerun MODVAL, if 
desired. 



MODVAL 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



ILLEGAL PRINT DENSITY SELECTION. 



ILLEGAL PRINT OPTION SELECTION. 



Output file message indicating a print 
density other than 3, 4, 6 or 8 lines 
per inch was specified or that no room 
would remain on the page after printing 
the header at the specified print density 
because the system value for lines per 
page is too small. 

Output file message indicating that an 
illegal list option was specified in a 
directive. 



Specify valid print DSDI 

density and rerun, or 

increase print density 

and/or contact site 

analyst to increase 

system value for lines 

per page. 

Correct and rerun. DSDI 



ILLEGAL REPORT OPTION. 



The OP parameter on the ASUSE control 
statement was not a letter from A through 
E. 



Correct the OP parameter 
and retry. 



ASUSE 



ILLEGAL - RF AND AM PARAMETERS. 



ILLEGAL - RF AND FM PARAMETERS. 



ILLEGAL - RL AND NO RF PARAMETER. 



ILLEGAL SDF DEVICE. 



ILLEGAL SL. 



ILLEGAL SU. 



ILLEGAL SUBFAMILY. 



ILLEGAL TASK PERCENTAGE. 



AM cannot be specified if RF is specified. 
Both AM and RF were specified on the ASVAL 
control statement. 

FM cannot be specified if RF is specified 
Both FM and RF were specified on the ASVAL 
control statement. 

RL can be specified only if RF is also 
specified. RF was not specified, but RL was 
specified on the ASVAL control statement. 

The equpment selected to receive a 
dead st art file does not meet the 
requirements of an RMS deadstart device. 

The SL parameter in a directive to ASDEBUG 
was not a number from through 15 or was 
greater than the SU parameter. 

The SU parameter in a directive to ASDEBUG 
was not a number from through 1 5 or was 
less than the SL parameter. 

The SB parameter on the ASUSE control 
statement or in a directive to ASLABEL or 
ASDEBUG was not a number from through 7. 

The task percentage specified exceeds 100. 



Specify either AM or RF, 
or neither AM nor RF, 
but not both. 

Specify either FM or RF, 
or neither FM nor RF, 
but not both. 

Either specify both RF 
and RL or neither. 



Ensure acuracy of 
control statement or 
select another device. 

Correct the SL parameter 
and retry. 



Correct the SU parameter 
and retry. 



Correct the SB parameter 
and retry. 



Correct task percentage 
in the task definition 
in the session file. 



ASVAL 



ASVAL 



ASVAL 



IIS 



ASDEBUG 



ASDEBUG 



ASLABEL , 
ASDEBUG, 
ASUSE 

STIMULA 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



ILLEGAL USER ACCESS. 



W 



ILLEGAL USER INDEX. 



ILLEGAL VALUE FOR MRES -- itm. 



ILLEGAL VALUE FOR OVLID — ovl. 



ILLEGAL VALUE FOR SR — x. 



IMPROPER NUMERIC PARAMETER. 



IMS - TRACK FLAWED, EQxx.Ttttt. 



INACTIVE DAYFILE NOT FOUND ON DEVICE. 



INACTIVE DAYFILE ON DEVICE. 



INACTIVE LOAD NOT ALLOWED. 



The user tried to perform an operation for 
which he is not validated. Possible causes 
include attempts to 

- run a system origin job from nonsystem 
origin 

- access a restricted subsystem without 
proper validation 

- enter an invalid SRU value 

- use the V carriage control character 
without validation 

Nonfatal K-display message indicating that 
the user index is greater than 18 bits. 

Specified memory resident must be 3- 
character alphanumeric item. The scan 
continues with the next item. 

Overlay identification must be a 3- 
character alphanumeric item with the first 
character A through 0. The scan continues 
with the next item. 

The skip record count x must be a single 
numeric digit. The scan continues with the 
next character. 

Nonfatal K-display message indicating that 
the field was too large, too small, or 
alphabetic. 

Flawed track found on equipment with EST 
ordinal xx and logical track tttt. 

An inactive dayfile of the specified type 
was not found on the specified device. 



An inactive dayfile already exists on the 
device on which a new active dayfile is to 
be created. 

The load parameters specify loading of 
inactive queues on a shared device, and 
QPROTECT is disabled. This is not allowed. 
The device must be a nonshared device, or 
the load must be changed to an active load, 



Ensure accuracy of 
control statement or 
determine proper vali- 
dation requirements 
via LIMITS statement. 



LFM, 

NETVAL, 

QFSP, 

RESEX, 

IMA 



Enter the correct user 
index. 

Correct error. 



Correct error. 



STIMULA 



LFG 



Correct error. 



Reenter the correct data. 



Hardware error. Contact 
customer engineer. 

Enter the correct family 
and device number using 
the K display. Use 
DFLIST to see where 
dayfiles reside. 

Enter another device 
using the K display. 



Enter the correct 
parameters and retry the 
operation. 



LFG 



LFG 



STIMULA 



IMS 



DFTERM 



DFTERM 



QLOAD 



MESSAGE 



INCOMPLETE DESTINATION FAMILY/USER. 



INDEX BUFFER LIMIT. 



INITIAL PF SPACE - n. 



INITIALIZATION PROBLEMS - BAD MSS 
CONFIGURATION. 

INITIALIZATION PROBLEMS - NO CSUMAPS FOUND. 



INITIALIZATION PROBLEMS - NO FAMILIES WITH 
8 CATALOGS FOUND. 

INPUT BUFFER SIZE EXCEEDED — INCREASE 
BUFLEN. 



INPUT FILE EMPTY. 
INQUIRING use mum. 

INQUIRY COMPLETE. 

INSTALL ABORTED. 

INSTALL - ARGUMENT ERROR. 

INSTALL FILE NOT FOUND. 
INSTALL FILE NOT MASS STORAGE. 



INSUFFICIENT CUBES. 
NUMBER PROCESSED - n. 



SIGNIFICANCE 



Either the DF or UN parameter was entered 
without the other. 

The limit for user indexes on a catalog 
track has been reached. 

Informative message indicating that the 
permanent file space at the beginning of the 
ASMOVE run is n PRUs. 

The EST is incorrect. 



CSU maps are missing. 
MSF catalogs are missing. 

NPUF indicates that a LINK-EDIT record 
larger than the buffer was encountered. 
This can occur if LFG tries to read a large 
garbage record from tape. 

The input file did not contain the required 
file description cards. 

Message displayed at line 1 of control 
point indicating that the user number 
U8ernum is being inquired. 

Dayfile message indicating that the inquiry 
is completed. 



The INSTALL control statement is 
syntactically incorrect. 



The file to be installed as a deadstart 
file was not found (is not assigned to the 
job control point). 



The file to be Installed as a deadstart 
file does not reside on mass storage. 



The number of cubicles to be added to the 
subfamily is more than the number of 
unassigned cubicles contained in the CSU. 
However, n cubicles were added. 



ACTION 



Specify both parameters 
and rerun utility. 

Increase index buffer 
length (INDBL). 

None. 



Correct the EST. 



Becover or recreate the 
missing CSU maps. 

Recover or recreate the 
missing MSF catalogs. 

Increase the input 
buffer size. 



Include file description 
cards and try again. 

None. 



None. 



The install job was aborted by the operator. None. 



Check parameters on 
INSTALL control 
statement. 

Assign the file to be 
installed to the job 
control point before 
calling INSTALL. 

If the file to be 
installed is a tape 
file, copy it to mass 
storage. 

Reassign empty cubicles 
presently assigned to 
another subfamily or 
acquire an additional 



ROUTINE 
FNTLIST 
PFCAT 
ASMOVE 

EXINIT 
EXINIT 
EXINIT 
LFG 

LFG 
MODVAL 

MODVAL 

IIS 
INSTALL 

IIS 
IIS 
ASLABEL 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



CSU. 



O 



INVALID AD IGNORED. 



INVALID CHANNEL NUMBER. 



INVALID CHARACTER AFTER ITEM p 



INVALID CS PARAMETER. 



INVALID DATA IN INPUT STREAM. 



The AD parameter of NDA has an invalid 
date. A valid date has the form AD=yymmdd. 



The channel number specified by the C=cc 
parameter on the LOADBC control statement 
is Invalid. 

NDA aborted because an illegal item was 
associated with call parameter p. 

The CS parameter on the ASVAL control 
statement was not a letter from A through M. 

Dayfile message indicating that the input 
file contains data that is incorrect. 



Correct the date on the 
AD parameter and try 
again. 

Correct the channel 
number and retry. 



Correct error and 
call NDA again. 

Correct the CS parameter 
and retry. 

Refer to the listing of 
the input stream for 
statements in error. 



NDA 



LOADBC 



NDA 



ASVAL 



FORMAT 



INVALID DEVICE SPECIFIED. 



INVALID FX PARAMETER. 



INVALID PARAMETER ON PROGRAM CALL CARD. 



INVALID SB PARAMETER. 



INVALID ST PARAMETER. 



INVALID SYSTEM SECTOR. 



INVALID TDAM REQUEST. 



Dayfile message indicating that the device 
specified is in an improper state for the 
selected operation to proceed. 

The FX parameter on the ASVAL control 
statement was not a number. 

Dayfile message indicating that at least one 
unrecognizable parameter was found on the 
FORMAT control statement. 

The SB parameter on the ASVAL control 
statement was not a numeric character 
string specifying some of the subfamilies 
from through 7. 

The ST parameter on the ASVAL control 
statement parameter was not a number. 

An error occurred while the system sector 
was being read. 

There is an internal error in PFM or PFU. 



Correct and rerun. 



Correct the FX parameter 
and retry. 

Correct and rerun. 



Correct the SB parameter 
and retry. 



Correct the ST parameter 
and retry. 

Inform site analyst. 



Inform site analyst. 



FORMAT 



ASVAL 



FORMAT 



ASVAL 



ASVAL 



QFM 



MSSEXEC 



INVALID USER ACCESS. 



INVALID VSN. 



The permanent files utilities were called by Ensure proper validation. 

a non-system origin user without proper 

validation. 



The VSN specified on an FX directive 
contains invalid characters; or the 
cartridge label for the current directive 
has an invalid VSN. 



Retry specifying a valid 
VSN; or use FX directive 
to relabel the cartridge. 



PFS 



ASLABEL 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



IQFT FILE ERROR DN dn FAMILY family. 



ISF COMPLETE. 



JOBNAME LIST FULL. 



KEY OVERFLOW ~ NEED TO INCREASE KEY SIZE. 



KEYWORD NOT EQUIVALENCED. 



****KRONOS INPUT DIRECTIVE IGNORED. 



LABEL ERROR, xxx. 
DESTAGE RESTARTED. 



O 



LABEL xxx MISMATCH, 
filenam STAGING ERROR, JOB»jobnam, 
FM-family, UI=userin, CSU=id, MST-n, 
VSN=vsn, ASA=addr, STRM=s. 



An error was encountered during an attach 
or read of the IQFT file. The message 
which follows this message in the dayfile 
describes the error. 

dn Device number 

family Family name 

Dayfile message indicating that ISF opera- 
tion is complete. 

K-display message indicating that the 
jobname list does not have room for the 
specified job name. The jobname list may 
have up to five job names entered. 

NPUF indicates that the SIS key was not 
large enough to write all the records in a 
memory resident. 

Output file message indicating that a 
keyword was entered without a value 
associated with it. 

Output file message indicating that a 
KRONOS input identifier (MS or PR) was 
encountered during a MODVAL (CV,OP-C) 
creation run. The system ignores the PR 
identifier and sets the MS field of the 
user number record to its default value. 

A file destage operation was abandoned 
because the cartridge label verification 
procedure for a selected cartridge 
encountered an error of type xxx on the 
stream selected for writing. These errors 
result in the stream conflict error flag 
being set in the MSF Catalog entry for that 
stream of that cartridge. The destage is 
automatically restarted and a different 
cartridge is used. 

xxx One of the following errors. 

CSU 

FAMILY 

READ PARITY 

STREAM 

VSN 

VSN AND CSU 

VSN AND XY 

XY 

The staging of file filenam was aborted and 
an error flag was set in the file's PFC 
entry because an error with xxx was detected 
during the stream label verification 



Inform site analyst. 



None. 



None. 



Increase the size of the 
SIS key. 



Correct and rerun. 



None. 



QDUMP 
QMOVE 



ISF 



QFSP 



LFG 



VALNET 



MODVAL 



Run ASVAL to identify 
the problem cartridge 
and stream and the 
affected permanent file, 
if any. Refer to Error 
Conditions and 
Corrective Action in 
section 3. 



MSSEXEC 



Retrieve the file from i 
dump tape if a backup 
copy is available. Run 
ASVAL to identify other 



MSSEXEC 



go MESSAGE SIGNIFICANCE ACTION ROUTINE 

oo 

o 

O procedure or the file label verification files, if any, that are 

procedure. All jobs attempting to attach affected by this error. 

this file will be aborted or given an error Either remove and 

response. The stream conflict error flag 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



M 



LDLIST OPERATION COMPLETE. 



LENGTH IN 52 TABLE .NE. FET. 



LEVEL-0 DATA BASE ERROR. 



LEVEL-1 INDEX BLOCKS LINKED. 



LEVEL-2 DATA BASE ERROR. 

LFG COMPLETE. 

LFG COMPLETE — ABNORMAL TERMINATION. 

*LFM* ERROR ON ERRxxx FILE. 



is set in the MSF Catalog entry for the 
affected cartridge and stream. 

xxx One of the following errors. 

ASA 

BACKLINK 

CSU 

FAMILY 

PRU 

STREAM NUMBER 

UI 

VSN 

XY 

Informative message indicating completion 
of QLOAD. 

The controlware record length in the 52 
table did not equal the controlware record 
length specified in the FET after the 
controlware was read into the LOADBC field 
length. 

Dayfile message indicating that a level 
block on the VALIDUs file was not present 
or was incorrect. 



Dayfile message indicating that index blocks 
are linked. 



Dayfile message indicating that a VALIDUs 
structure error in the level 2 block 
was detected. 

LFG terminated normally. 

LFG terminated abnormally. 



During the file rename, lock, and common 
sequence to save error file ERRxxx, an LFM 
error occurred. 

xxx Sequence number from 001 through 999. 



reassign the cartridge 
or run ASDEBUG to clear 
the stream conflict 
error flag. Refer to 
Error Conditions and 
Corrective Action in 
section 3. 



None. 



Check system controlware 
records. 



Ensure that the file is 
local and contains valid 
level and level 1 
blocks (at least one 
user entry) and rerun. 

None, although if the 
validation file can be 
reformatted to eliminate 
block linkage, searches 
will be faster for user 
numbers residing in 
linked blocks and for 
nonexistent user numbers 
which would have resided 
in linked blocks. 

Inform site analyst 
immediately. 



None. 

Determine cause from 
other error messages. 

Inform site analyst. 



QLOAD 



LOADBC 



MODVAL 



MODVAL 



MODVAL 

LFG 
LFG 

QLOAD 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



LINE SPEED OUT OF RANGE. 



LIST COMPLETE. 



LISTING REMAINING FILES. 



Output file message indicating that a line 
speed value was entered which was not in the 
range of 1 through 2047. 

Informative message on the K display indi- 
cating that the LIST command has completed. 

Informative message indicating that the 
remaining catalog image files are being 
listed. 



Correct and rerun. 



None. 



None. 



VALNET 



QREC, 
FNTLIST 

PFLOAD 



LOAD FILE MISPOSITIONED. 



Either of the following situations has 
occurred. 

- A file position function indicated an 
attempt to position beyond EOI. 

- During a file read function, the 
control word read was not the expected 
control word. 



Rewind the load file 
and retry the operation. 



QLOAD 



LOAD FILE POSITION LOST. 



LOADING filenam userin. 



Position on the load file was lost during 
the write error recovery sequence. 

Informative message indicating the name of 
the file currently being loaded and the 
associated user index. 



Retry or inform site 
analys t . 

None. 



QLOAD 
PFLOAD 



LOADING - DIRECT ACCESS FILES ONLY. 



LOADING FROM xxx TO yyy. 



LOADING - INDIRECT ACCESS FILES ONLY. 



LOST STIMOUT DATA. 



Informative message Indicating that only 
direct access files have been selected to 
be loaded (OP-D option specified) . 

Informative message indicating the device 
from which the files being loaded came 
and the device to which they are being 
loaded. 

xxx Device mask of the device that was 
dumped to the archive tape being 
loaded 
yyy Device mask of the device to be 
loaded 

Informative message indicating that only 
indirect access files have been selected to 
be loaded (OP-I option specified) . 

Nonfatal output file message indicating that 
the buffer has overrun, since CIO is not 
servicing the stimulator output buffer fast 
enough. 



None. 



None. 



PFLOAD 



PFLOAD 



None. 



Reassemble STIMULA with 
a larger output buffer, 
reduce line speed or 
input speed, or increase 
think time for stimula- 
tion. 



PFLOAD 



ITS, 
1TE 



ni 



MESSAGE 
LT OPTION NOT SPECIFIED CORRECTLY. 

MAINLOG - message 

MAINLOG - FR TIME VALUE ILLEGAL. 

MAINLOG - LINKAGE ERROR. 



MAINLOG - OP OPTION ILLEGAL. 



MAINLOG - RECOVERY SECTOR ENCOUNTERED. 



MAINLOG - TTY BINARY OUT-FILE NOT ALLOWED. 

MAINTENANCE LOG DUMPED. 
MANUFACTURING DATA INVALID. 



MASTER USER NUMBER REQUIRED. 



MAXIMUM NUMBER OF ARGUMENTS. 



SIGNIFICANCE 

The LT option is valid only with the RM 
directive; LT was specified in another 
directive to ASLABEL. 

Refer to the explanation of AFD - message if 
the message is not among the individually 
documented MAINLOG messages. 

The time specified via the FR option cannot 
be converted to a packed time for 
searching the binary maintenance log. 

The beginning of the next message is not 
clearly indicated because the offset in the 
previous maintenance log message does not 
agree with the sector offset. The utility 
assumes the maintenance log message offset 
is in error, skips the message containing 
it, and resumes processing with the message 
indicated by the sector offset. 

The specified option is not valid when 
dumping the binary maintenance log. 

A level 0, 1 , or 2 deadstart was performed 
at this point in the binary maintenance log. 
If the utility detects a linkage error it 
discards any message fragment being 
processed. 

The binary maintenance log cannot be 
written to a terminal (TT) device type. 



Dayfile message indicating that: one of the 
factory-recorded sectors, containing either 
manufacturing or flaw data, is either 
unreadable or not present. 



Dayfile message indicating that the job did 
not enter a user number (via USER statement) 
This is needed for a master user list run 
and for a master user inquire run. 

Dayfile message indicating that only the 
first 30 bit numbers were accepted on a SET. 
or a CLEAR, command. 



ACTION 

Correct the directive 
and retry. 



ROUTINE 
ASLABEL 



Retry with a valid time 
specified. 



None. 



DAYFILE 



DAYFILE 



Be try with a valid 
option. 

Always checkpoint the 
system before performing 
a level 0, 1 , or 2 
deadstart. 



Specify a non-TT 
destination file. 



The binary maintenance log dump is complete. None. 



Refer to the output 
listing for a detailed 
status report indicating 
the actual problem. If 
the factory-recorded data 
cannot be read, the pack 
cannot be processed using 
this utility. Customer 
engineering must be 
contacted to add this 
format information 
off-line. 

Rerun job with USER 
statement validation. 



Correct and reenter. 



DAYFILE 



DAYFILE 



DAYFILE 

DAYFILE 
FORMAT 



PROFILE 



SCRSIM 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



MEMORY OVERFLOW. 



MEMORY REQUEST ERROR. 



MISSING CARTRIDGE. 
DESTAGE RESTARTED. 



MISSING CARTRIDGE. 

filenam FOR jobnam NOT FOUND ON MSS. 



MISSING EOR. 



There is no more space left in memory for 
SYSEDIT internal tables. 



Fatal dayfile message indicating that 
STIMULATOR and ITS do not agree on the 
correct field length. 

A file destage operation was restarted 
using a different cartridge because the 
selected cartridge could not be found in its 
assigned cubicle. 



The staging of file filenam for job jobnam 
was abandoned because a cartridge was 
missing. 



Logical EOR missing on the file being 
loaded (invalid data). File is truncated 
and length of file is updated in catalog. 
This message is followed by the message 
PFLOAD - TAPE ERROR filenam user in. 



Reduce the number of 
programs to SYSEDIT and 
retry. 

Rerun job; this could be 
caused by a system 
failure. 

Run ASUSE (OP=B) to 
identify the lost 
cartrige. When it is 
located, run ASLABEL to 
restore it to its 
proper cubicle. 

When the cartridge is 
located, a site analyst 
should run ASLABEL to 
restore it to its proper 
cubicle. (Refer to 
section 3 of the NOS 
System Maintenance 
Reference Manual.) 

Retry or use backup 
tape. 



SYSEDIT 



ITS, 
1TE 



EXDEST 



EXSTGE 



PFLOAD 



****MISSING VALUE. 



Output file message indicting that the 
user has specified a directive identifier 
without a value. 



Correct and rerun. 



PROFILE 



MODIFIED AFTER yy/mm/dd. hh.mm.ss. 



MODIFIED BEFORE yy/mm/dd. hh.mm.ss 



Informative message indicating that files None, 
modified after the specified date and time 
have been loaded (or dumped) . 

Informative message indicating that files None, 
modified before the specified date and time 
have been loaded (or dumped) . 



PFLOAD, 
PFDUMP 



PFLOAD, 
PFDUMP 



MODVAL ABORTED. 



MRF PROCESSING COMPLETE, FM-family. 



MS ERROR ON DEADSTART FILE. 



MS LOAD FILE NOT PRESENT. 



Dayfile message indicating that a control 
point error flag has been set. 

Informative message indicating that MSSEXEC 
processing of file MOVCOM for the family 
indicated is complete. 

A mass storage error was encountered while 
the deadstart file was being written. 

A mass storage load file requested by ME=*MS 
was not at the control point. 



Consult the dayfile 
listing for reason. 

None. 



Use FORMAT to reserve 
the bad sector. 

Assign mass storage 
file and repeat call. 



MODVAL 



EXDEST 



US 



QLOAD 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



O 



MSF CATALOG CHAIN LINKAGE BAD. 
filenam STAGING ERROR, JOB=jobnam, 
FM-family, UI=userindex, CSU=id, MST-n, 
VSN=vsn, ASA=addr, STRM=s. 



A linkage error was encountered on the MSF 
catalog. 



A site analyst should 
run ASVAL to report on 
the problem and take 
appropriate corrective 
action. (Refer to 
section 3 of the NOS 
System Maintenance 
Reference Manual.) 



EXSTGE 



MSF CATALOG ERROR FLAGS SET. 
filenam FOR jobnam. 



Informative message indicating that the 
frozen chain flag or stream conflict flag 
was set on one or more streams of file 
filenam. The file is staged successfully 
unless other messages are issued which 
indicate reasons why the stage is delayed 
or aborted. 



Run ASVAL to identify 
the error flags that 
are set and take 
appropriate action. 
Refer to Error 
Conditions and 
Corrective Action in 
section 3. 



EXSTGE 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



O 



MSF CATALOG INTERLOCKED. 
DESTAGE DELAYED, 
FM=family, SF=sub. 



A file destage operation was delayed because 
the MSF catalog for the family and subfamily 
indicated is being accessed. The destage 
will resume when the MSF Catalog becomes 
available. 



None. 



MSSEXEC 



MSF CATALOG INTERLOCKED. 

STAGING DELAY, FM=family, UI=userin. 



MSF CATALOG NOT ONLINE. 
DESTAGE ABANDONED, 
FM=family, SF-sub. 



MSF CATALOG NOT ONLINE, 
filenam FOR jobnam NOT STAGED. 



MSF CATALOG OPEN ERROR. 



MSF CATALOG PARITY ERROR. 



Staging is delayed because PFDUMP or ASVAL 
is accessing the MSF Catalog. Staging will 
resume automatically when the interlock is 
no longer needed. 

A file destage operation was abandoned 
because the MSF catalog for the family and 
subfamily indicated was not on line. The 
next ASMOVE run for this subfamily will 
reselect these files for destaging. 

The staging of file filenam for job jobnam 
was abandoned because the MSF catalog was 
not on line. This condition exists when a 
removable family is mounted after MSSEXEC 
was initiated or when an I/O error occurred 
on the MSF catalog. 

The MSF catalog does not exist or is invalid 
for the specified family and subfamily. 



There is a read parity error on the MSF 
Catalog. 



None. 



None. 



A site analyst should 
ensure that the MSF 
catalog is on line and 
recover from the I/O 
error, if necessary. 
Then restart MSSEXEC. 

Correct the SB parameter 
on the ASVAL control 
statement or reload/ 
recreate the MSF 
catalog. 

Recover the MSF Catalog 
from a backup copy and 
retry. 



MSSEXEC 



MSSEXEC 



MSSEXEC 



ASVAL 



ASUSE 



MSF CATALOG READ ERROR. 



A parity error was encountered on the MSF 
Catalog. 



Recover the MSF 
catalog from a 
backup copy and 
retry. 



ASVAL 



MSF CATALOG READ ERROR. 
DESTAGE ABANDONED, 
FM=family, SF=sub. 



MSF HARDWARE PROBLEM. 



A file destage operation was abandoned 
because the MSF catalog for the family and 
subfamily indicated contained a read error. 
This error may result in subsequent MSF 
CATALOG NOT ONLINE messages. 

The directive to ASLABEL or ASDEBUG cannot 
be processed at this time because of an MSF 
hardware failure. 



Investigate cause of 
error and take 
appropriate corrective 
action. 



Rerun after a repair 
has been made. 



MSSEXEC 



ASLABEL 
ASDEBUG 



MSF SYSTEM ERROR. 



There are problems with the MSS software 



Inform site analyst. 



ASDEBUG 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



MSS ACTIVE. 



MSSDRVR ABNORMAL, xxx. 



Informative message indicating that the Mass 
Storage Subsystem is active at a control 
point. 

There is an internal error in module xxx of 
the MSS driver. 



None. 



Inform site analyst. 



MSSEXEC 



MSSEXEC 



MSSEXEC SEEKING FL INCREASE. 



MULTIPLEXER CHANNEL UNDEFINED ON 
PREVIOUS MUX DESCRIPTION. 



MSSEXEC needs space for its tables before it 
can be initialized. 



Output file message indicating that no 
channel parameter was specified on the 
previous multiplexer definition directive. 
This is mandatory for //STIM, //6671 , and 
//6676 directives. 



Take action to make 
additional memory 
available. 

Correct and rerun. 



MSSEXEC 



VALNET 



MULTIPLEXER DESCRIPTION EXPECTED. 



MULTIPLEXER EQUIPMENT UNDEFINED ON 
PREVIOUS MUX DESCRIPTION. 



Output file message indicating that no 
multiplexer definition directive was 
specified. This directive should precede 
a set of terminal definition directives. 

Output file message indicating that no 
equipment parameter was specified on the 
previous multiplexer definition directive. 
This is mandatory for //STIM, //6671 , and 
//6676 directives. 



Correct and rerun. 



Correct and rerun. 



VALNET 



VALNET 



NEW DESTINATION USER/FAMILY INVALID. 



NO ACTIVE DAYFILE FOUND. 



NO BITS SPECIFIED. 



K-display message indicating that the user 
number specified by NUN is not on the 
VALIDUs file in the family specified by NDF. 

An active dayfile of the specified type 
was not found in the QFSP equipment table. 



Dayfile message indicating that no bit 
numbers were specified on a SET. or a CLEAR, 
command . 



Ensure accuracy of 
NUN and NDF parameters 
and rerun. 

Stop this DFTERM run, 
start another DFTERM 
run, and retry the 
operation. If the error 
still exists, check 
system for loss of 
dayfile. 

Correct and reenter. 



FNTLIST 



DFTERM 



SCRSIM 



NO CARTRIDGE AVAILABLE IN POOL. 



A cartridge from the pool is needed so that 
the directive to ASLABEL can be processed. 



Assign more cartridges 
to the pool or change 
the directive. 



ASLABEL 



O 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



****NO CHARGE NUMBER IN EFFECT. 



Output file message indicating that a charge 
number must be in effect before any charge 
value or project directives can be 
processed. 



Enter a correct charge 
number directive before 
proceeding. 



PROFILE 



NO CONTROLWARE ON CHANNEL. 



The CCTL channel table indicates that no 
controlware exists on the requested channel. 



Check the C=cc parameter 
on the LOADBC control 
statement and retry. 



LOADBC 



NO DATA BLOCK. 



DATA control word was not found when PFLOAD 
expected data for current file; length is 
set to zero. This is a nonfatal system 
error and is followed by the message 
PFLOAD - TAPE ERROR filenam user in. 



Retry or use backup 
tape • 



PFLOAD 



NO DESCRIPTIONS FOUND. 



Dayfile message indicating that no 
multiplexer and/or terminal descriptions 
were found on the description record. 



Ensure that the correct 
file is specified with 
the P option on the 
VALNET control statement 
and rerun. 



VALNET 



NO DEVICES IN THE FAMILY. 



The family specified by the FM parameter on 
the ASMOVE control statement has no devices 
on line. 



Bring the devices on 
line or specify a 
different family. 



MAC2 



NO DIRECTIVES PROCESSED. 



No directives were specified on the DSDI 
control statement. 



Reenter control statement 
with directives 
specified. 



DSDI 



NO DUMPS FOUND FOR NPU - npu. 



User-specified NPU name, npu, was not found 
in the dump file index. 



Correct NPU 
specification and try 
again. 



NDA 



NO EMPTY CARTRIDGES AVAILABLE IN FAMILY, 



There are no empty cartridges that the RM 
directive to ASLABEL can remove. 



None. 



ASLABEL 



NO EMPTY CUBE IN FAMILY /POOL. 



Empty cubicles assigned to the family/pool 
are needed so that the directive to ASLABEL 
can be processed. 



Assign more cubicles 
the family/pool or 
change the directive. 



ASLABEL 



NO EMPTY CUBES. 
NUMBER PROCESSED-n. 



There are no more empty cubicles in the 
family/pool/reserved area. The RB directive 
to ASLABEL could remove only n cubicles. 



None. 



ASLABEL 



NO EOI FOR FILE. 



Next catalog (or other control word type 
that logically precedes the previous DATA 
control word) was found before EOI was 
detected for the current file. Length is 
updated in catalog entry. This is a non- 
fatal system error and is followed by the 
message PFLOAD - TAPE ERROR filenam userin. 



Retry or use backup 
tape. 



PFLOAD 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



NO FILES PROCESSED. 



NO GENERAL STATUS RECEIVED. 



NO INACTIVE QUEUED FILES PRESENT. 



NO INACTIVE QUEUES ON DEVICE. 



NO MANUFACTURER OR SCRATCH LABEL. 



NO MATCHING FAMILY LABEL. 



NO MORE RECORDS OF TYPE x TO PROCESS. 



NO MSF SPACE. 

DE STAGE ABANDONED, 

FM-family, SF-sub, CSU-id. 



NO MSF SPACE. 

DE STAGE ABANDONED, 

FM=faraily, SF«sub. 



Informative message indicating that no 
files have been loaded, cataloged, or 
copied during the utility run. 



After the function was performed, no status 
word was received. 

No inactive queues were found during the 
processing of a LIST command. 

Informative message indicating that the 
LIST command failed to find any inactive 
queued files on the device specified on the 
K display by the FM/DN parameter. 

The cartridge to be added has a label of 
unknown type. 



The family or subfamily in the cartridge 
label does not agree with the values 
specified in the directive to ASLABEL. 

Processing of record type x requires more 
records of type x than can be found in the 
dump file. 

A file destage operation was abandoned 
because of insufficient MSF space; id is 
the CSU identifier of the CSU with the most 
space available. 



A file destage operation was abandoned 
because there was no CSU assigned to the 
indicated family and subfamily with any 
space available. 



None. 



Inform customer 
engineer. 

None. 



None. 



Discard the cartridge or 
use the FX directive to 
ASLABEL to restore the 
label. 

Try restoring the 
cartridge or use correct 
family and subfamily. 

Analyze error and 
try again. 



Either use ASLABEL to 
add cartridges to the 
specified subfamily or 
use ASVAL to purge 
unneeded MSF space. 
ASUSE can be used to 
report on the 
availability of space 
for each CSU and 
subfamily. 

Run ASUSE to obtain a 
report on the 
availability of 
cartridge space. If 
enough space is 
available on a CSU, 
ensure that the CSU and 
at least one MST is 
available for use. If 
adequate space is not 
available, use ASLABEL 



PFATC, 
PFCAT , 
PFCOPY, 
PFLOAD 

LOADBC 

QREC 

QREC 

ASLABEL 

ASLABEL 

NDA 

EXDEST 



EXDEST 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



NO OFF CARTRIDGE LINK. 
DESTAGE RESTARTED. 



NO OUTPUT FILE EXISTING. 



A file destage operation was restarted 
using a different cartridge because, the 
selected cartridge could not contain the 
remainder of the file and could not be 
linked to another cartridge. 

K-display message indicating that no output 
file was created before the OUT command 
was entered. 



to add cartridges to 
the subfamily or use 
ASVAL to purge 
unneeded MSF space. 

None. 



None. 



EXDEST 



DFTERM 



NO OUTPUT FILE EXISTS. 



K-display message indicating that no output 
file was created before the OUT command 
was entered. 



None. 



QDUMP, 
QMOVE 



NO OUTPUT FILE PRESENT. 



The OUT command was entered but QLOAD 
could not find an output file to release. 



Create an output 
file and retry 
operation. 



QLOAD 



NO PARAMETER SUPPLIED. 



There is no channel parameter (C=cc) on the 
LOADBC control statement. 



Add the C-cc parameter 
to the LOADBC control 
statement. 



LOADBC 



NO PERMANENT DAYFILES. 



****N0 PROJECT NUMBER IN EFFECT. 



NO QUEUED FILES FOUND. 



Informative message indicating that no 
permanent dayfiles exist on any permanent 
file device. 

Output file message indicating that a 
project number must be in effect before any 
project value directives can be processed. 

No queued files meet the specified 
selection criteria. 



None. 



Enter a project number 
directive before 
proceeding. 

Ensure that correct 
selection criteria were 
entered and rerun. 



DFTERM 



PROFILE 



FNTLIST 



NO STIMULATOR TERMINALS DEFINED. 



NO SUCH CSUMAP OR SUB-CATALOG. 



Fatal dayfile message indicating that the 
time-sharing subsystem has not been 
intiialized using the stimulator EST entry. 

The CSU specified by the CS parameter is not 
assigned to the subfamily specified by the 
SB parameter. 



Correct and rerun. 


ITS, 




1TE 


Correct the CS and/or 


ASLABEL 


SB parameter on the 




ASLABEL control 




statement. 





NO SUCH SUB CATALOG. 



The CSU specified by the CS parameter is 
not assigned to the subfamily specified by 
the SB parameter. 



Correct the CS and/or 
SB parameter. 



ASDEBUG 



MESSAGE 



NO TTYS ASSIGNED. 



****NO USER INDICES AVAILABLE. 



NO 52 TABLE IN CONTROLWARE RECORD. 



NO 77 TABLE IN CONTROLWARE RECORD. 



NON FROZEN FRAGMEN. 



NOT ENOUGH ARGUMENTS. 



NOT ENOUGH MASS STORAGE. 



****NOT MASTER USER. 



SIGNIFICANCE 



There are no terminals assigned to the 
sessions. 

Output file message indicating that no more 
user indices are available for automatic 
assignment. If entered from the K display, 
the line of input on which the error 
occurred is disregarded; otherwise, that 
particular user number is disregarded. 



The controlware read from the system file 
did not contain a 52 table entry. 

The controlware read from the system file 
did not contain a 77 prefix table entry. 

The specified fragment which ASDEBUG was 
requested to release did not have the frozen 
flag set. 

Dayfile message indicating that before the 
correct number of arguments was specified, a 
terminator was encountered. 

Not enough mass storage exists on the 
specified device to enable creation of a 
new active dayfile. 

Output file message indicating that the user 
is neither a master user of a specified 
charge number, a special accounting user, 
nor from system origin, as is required for 
the directive entered. 



ACTION 



Enter assigned terminals 
using the MX directive. 

Rerun the corrected job 
or correct the new 
validation file using 
the FUI directive 
(force user index to be 
inserted or changed) to 
specify user indices. 

Check the system 
controlware records. 

Check the system 
controlware records. 

Correct the directive 
and retry. 



Correct and reenter. 



Enter new device using 
the K display. 



None. 



ROUTINE 



STIMULA 



MODVAL 



LOADBC 



LOADBC 



ASDEBUG 



SCRSIM 



DFTERM 



PROFILE 



NOTICE*** CHECKPT BOUNDARY - n WORDS LOST. 



NOTICE*** DATA READ ERROR - n WORDS LOST. 



NOTICE*** FILE TOO LONG - n WORDS. 



NOTICE*** FILE TOO SHORT - n WORDS LOST. 



NPU TYPE ERROR IN DUMP NUMBER dmp. 



NS STATISTICS. 



The utility discarded a message fragment of 
n words upon encountering a checkpoint 
boundary. 

Read error caused loss of n words in the 
dayfile. 

The dayfile is n words longer than the 
system file manager reported to DAYFILE. 

The dayfile is n words shorter than the 
system file manager reported to DAYFILE. 

The header record of dump number dmp 
contains an illegal NPU type. 

The values following this message are used 
for internal maintenance and tuning only. 
Refer to NS program listing if further 
information is needed. 



None. 



None. 



Inform site analyst. 



Inform site analyst. 



Correct the header and 
try again. 

None. 



DAYFILE 



DAYFILE 



DAYFILE 



DAYFILE 



NDA 



NS 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



W 



NUMBER OF BITS TOO LARGE. 



Dayfile message indicating that the number 
of bits entered on the AREA, command was 
larger than the number of bits from the 
starting bit to the end of the register. 



Correct and reenter. 



SCRSIM 



NUMBER OF CYCLES TOO LARGE. 



NUMBER OF LINE REGULATIONS - nnnnnn. 



Dayfile message indicating that the number 
of cycles specified on the CYCLE, command 
was greater than 4095. 

Informative dayfile message Indicating the 
number of time line regulations (REPEAT..) 
that were encountered. 



Correct and reenter. 



To reduce the number of 
line regulations, 
reduce the stimulator 
load by reducing the 



SCRSIM 



STIMULA 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



O 



number of terminals or 
by increasing the think 
time or think time 
increment. 



NUMBER OF RECORDS WRITTEN n. 



NUMERIC CONSTANT ERROR. 



OBSOLETE MSF CATALOG ONLINE, 
filenam FOR jobnam NOT STAGED. 



The number of records written to the NPU 
load file, NPUFL, was n. 

Output file message indicating any of the 
following. 

- Nonnumeric characters were present in 
a numeric constant. 

- An 8 or 9 was present in a constant 
value with a postradix B. 

- A character followed the postradix. 

The staging of file filenam for job jobnam 
was abandoned because an obsolete MSF 
catalog was used. 



None. 



Correct and rerun. 



LFG 



VALNET 



Recover the current copy 
of the MSF catalog. A 
site analyst should run 
ASVAL to analyze the 
MSF catalog and the PFC 
entries (refer to 
section 3 of the NOS 
System Maintenance 
Reference Manual) . 



EXSTGE 



ON, OFF NOT SPECIFIED CORRECTLY. 



ON and OF are valid only with the IB 
directive; ON or OF was specified on another 
directive to ASLABEL. 



Correct the directive 
and retry. 



ASLABEL 



OUTPUT FILE NAME CONFLICT. 



OUTPUT FILE RELEASED. 



The specified output file name conflicts 
with a name already in use. 

Informative message on K display indicating 
that output file was released to the 
printer. 



Change the output file 
name and retry operation. 

None. 



QMOVE 



DFTERM 

QREC 

QMOVE 

QDUMP 

QLOAD 

FNTLIST 



OVERLAY SIZE EXCEEDS OVERLAY AREA. 



P.F. DEVICE dn DUMPED. 



The word count in the overlay area header 
record does not match that in the overlay 
header, possibly indicating a bad CCP 
binary input file. 

Informative message indicating that, dumping 
of permanent files from device with device 
number dn is complete. 



Check the CCP binary 
input file. 



None. 



LFG 



PFDUMP 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



P.F. DEVICE dn LOADED. 



PACK packnam LOADED. 



Informative message indicating that loading None, 
of permanent files from device with device 
number dn is complete. 

Informative message indicating that the None, 
auxiliary device, identified by packnam, 
has been loaded. 



PFLOAD 



PFLOAD 



PACKNAME packnam DUMPED. 



PAGING COMPLETE. 



PARAMETER DN OR NPU MISSING. 



PARAMETER value ILLEGAL FOR nam. 



PARITY ERROR IN CATALOG IMAGE dm ct. 



Informative message indicating that the 
auxiliary device, identified by packnam, 
has been dumped . 

Informative message on the K display 
indicating that page advancing command 
(+) has completed. 

Neither DN nor NPU is specified on the NDA 
call. 



NDA has detected an illegal parameter value 
value The illegal parameter value, 
nam The parameter name DN, NPU, B, 
E, or LO. 

Parity error was encountered while PFLOAD 
read catalog image information for catalog 
track ct for the master device with device 
mask dm. Operator entry of K.GO causes the 
affected catalog track to be skipped but 
other catalog tracks to be processed. 
Entering anything else causes the load to 
abort. 



None. 



None. 



PFDUMP 



QREC 



Specify either DN or NPU 
on the NDA call and try 
again. 

Correct parameter and 
call NDA again. 



Enter E to terminate 
loading, L to list 
remaining files, GO to 
resume incremental load. 



NDA 



NDA 



PFLOAD 



****PASSWORD REQUIRED. 



A password was not encountered for the user 
number being created. If MODVAL is being 
run from batch, the user number is not 
created. 



Specify a password if at 
K display or correct and 
rerun if from batch. 



MODVAL 



PERMANENT DAYFILE DEFINED AS filenam. 



Informative message indicating that the 
dayfile has been terminated and defined 
under the name filenam. 



None. 



DFTERM 



PERMANENT DAYFILE LIST COMPLETE. 



PERMANENT FILE PROBLEM. 



K-display message for DFTERM or output file 
message for DFLIST indicating that the 
permanent dayfile list is complete. 

A permanent file error was encountered on 
the CSU map or the MSF catalog. 



None. 


DFLIST 




DFTERM 


Recover the CSU map or 


ASDEBUG 


MSF catalog. 





o 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



M 



PERMIT RI RANGE ERR filenam userin. 



PERMITS MISSING. 



Random index of the permit information for 
file filenam is not within the legal 
range. This is a nonfatal system error. 

Permit information on archive tape is 
missing or incomplete. This is a nonfatal 
system error and is followed by the message 
PFLOAD - TAPE ERROR filenam userin. 



Inform site analyst. 



Retry or use backup tape. 



PFDUMP 



PFLOAD 



PERMITS PRESENT THAT SHOULD NOT BE. 



Permit block was found on tape but no pre- 
vious permit random index was found in the 
catalog. Data is considered invalid and 
the file is skipped. This is a nonfatal 
system error and is followed by the message 
PFLOAD - TAPE ERROR filenam userin. 



Retry or use backup tape. 



PFLOAD 



PF ATTACH ERROR-ec ON DIRECTORY. 



PF ATTACH ERROR-ec ON DUMP FILE. 



PF PROBLEM. 



PF SPACE RELEASED - n. 



PF SPECIFIED BUT NOT UI. 



Permanent file error ec was returned after 
an attempt to attach the dump directory. 
Refer to the NOS Reference Manual, volume 2, 
for the error code meanings. 

Permanent file error ec was returned after 
attempt to attach the dump file. Refer to 
volume 2 of the NOS Reference Manual for 
error code meanings. 

A permanent file error was encountered on 
the CSU map or the MSF catalog. 

Informative message indicating that the 
permanent file space released by ASMOVE is n 
PRUs. 

User index associated with permanent file 
name specified is required but was not 
entered. 



Correct error and 
try again. 



Correct error and try 
again. 



Recover the CSU map or 
MSF catalog. 

None. 



Reenter parameters and 
specify both file name 
and user index. 



NDA 



NDA 



ASLABEL 



ASMOVE 



PFS 



PFATC ABORTED. 



A fatal error occurred causing PFATC to 
abort. 



Check dayfile for other 
error messages to aid in 
determining the cause of 
this error. 



PFATC 



PFATC - PARITY ERR filenam userin. 



PFATC - PFC /PERMITS ONLY AVAILABLE filenam 
userin. 



Parity error was encountered on tape while 
cataloging file filenam; file is skipped. 
This is a nonfatal system error. 

Informative message indicating that only the 
PFC entry and permit information for file 
filenam were encountered on the archive file 
(the file data was not available). It is 
assumed that the file date lides on the 



Retry or use backup tape. 



None. 



PFATC 



PFATC 



MESSAGE 



> 



SIGNIFICANCE 



ACTION 



ROUTINE 



PFCAT ABORTED. 



PFCAT COMPLETE. 



PFCAT - ILLEGAL DEVICE NUMBER filenam 
userin. 



PFCOPY ABORTED. 



PFCOPY - DATA CONTROL WORD ERROR. 



PFCOPY - PARITY ERR filenam userin. 



PFCOPY - SYSTEM SECTOR TOO LONG. 



PFCOPY - SYSTEM SECTOR TRUNCATED. 



a 



PFDUMP yy/mm/dd. hh.mm.ss. 

PFDUMP - ABORT REPRIEVE BEGINS. 
PFDUMP - ABORT REPRIEVE COMPLETED. 

PFDUMP ABORTED. 



Mass Storage Facility. 

A fatal error occurred causing PFCAT 
to abort. 



Informative message indicating that the 
catalog of the permanent file device is 
complete. 

The device number specified in the catalog 
entry for file filenam with user index 
userin is the number of an alternate device 
that cannot be found. 

A fatal error occurred causing PFCOPY to 
abort. 



A data control word was expected on the dump 
file but was not found. 

Parity error was encountered on tape while 
PFCOPY copied file filenam; file is skipped. 
This is a nonfatal system error. 

The word count for a system sector exceeds 
the standard system sector length; probable 
cause Is that two parts of different split 
system sectors were joined. The affected 
file is skipped. Processing continues with 
the next file. 

The word count for a system sector is less 
than the standard system sector length; 
probable cause is that part of a split 
system sector is missing. The affected 
file is skipped. Processing continues with 
the next file. 

Informative message indicating date and 
time of dump. 

Marks start of PFDUMP's abort processing. 

Marks completion of PFDUMP's abort 
processing. No further PFDUMP processing 
occurs after this message is issued. 

A fatal error occurred causing PFDUMP to 
abort. 



Check dayfile for other 
error messages to aid in 
determining the cause of 
the abort. 

None. 



Mount the missing 
removable pack and retry 
the operation. 



Check dayfile for other 
error messages to aid in 
determining the cause of 
this error. 

Retry or use backup 
tape. 

Retry or use backup tape. 



Retry or use backup 
tape. 



Retry or use backup 
tape. 



None. 

None. 
None. 



Refer to accompanying 
error message to aid in 
determining the cause of 
the abort. 



PFCAT 



PFCAT 



PFCAT 



PFCOPY 



PFCOPY 



PFCOPY 



PFCOPY 



PFCOPY 



PFDUMP 

PFDUMP 
PFDUMP 

PFDUMP 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



O 



PFDUMP - ALTERNATE STORAGE ERROR, 
FN - filenam, 
UI - userin. 



The permanent system error-flag was set for 
the specified file. The MSS executive sets 
this flag when either the alternate storage 
address does not provide a valid path to the 
file's data, or an unrecoverable parity 
error occurs on an MSS cartridge. This file 
is not written to the archive file. Dumping 
continues with the next file. 



None. 



PFDUMF 



PFDUMP - CATALOG FORMAT ERROR, FM=family, 
DNdn,EQeq,Ttttt,Sssss. 



The catalog format on the specified family 
device is not supported by the system. If 
this is the only device to be dumped, the 
dump aborts. Otherwise, the dump continues 
with the next device. 



Mount the device on a 
system using the same 
catalog format as that 
of the system on which 
it was created. Dump 
the files, initialize 
the device, and then 
reload the files on a 
system using the desired 
catalog format. 



PFDUMP 



PFDUMP - CATALOG FORMAT ERROR, PN-packn am, 
EQeq,Ttttt,Sssss. 



The catalog format on the specified 
auxiliary device is not supported by the 
system. 



Mount the device on a 
system using the same 
catalog format as that 
of the system on which 
it was created. Dump 
the files, initialize 
the device, and then 
reload the files on a 
system using the desired 
catalog format. 



PFDUMP 



PFDUMP - CATALOG READ ERROR, 

PN-packnara,EQeq,Ttttt,Sssss. 



A mass storage error occurred while PFDUMP 
read catalog information on the specified 
auxiliary pack. The equipment number, 
logical track, and logical sector are given. 
Files cataloged in the bad sector are not 
dumped. If possible, dumping continues 
with the next sector of the affected 
catalog track. Otherwise, dumping continues 
with the next catalog track or device as 
appropriate for the dump type. Error idle 
status is set for the device. 



Analyze error and try 
again. If error 
persists, assume cause 
is hardware 
malfunction. 



PFDUMP 



PFDUMP - CATALOG READ ERROR, FM-family,DNdn, 
CTct,EQeq,Ttttt,Sssss. 



A mass storage error occurred while PFDUMP 
read catalog information on the specified 
family, device number, logical catalog track, 
equipment number, logical track, and 
logical sector. Files cataloged in the bad 
sector are not dumped. If possible, dumping 
continues with the next sector of the 
affected catalog track. Otherwise, dumping 
continues with the next catalog track or 
device as appropriate for the dump type. 
Error idle status is set for the device. 



Analyze error and try 
again. If error 
persists, assume cause 
is hardware malfunction. 



PFDUMP 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



PFDUMP - CATALOG READ ERROR, FN-filenam, 
Ul-userin. 



File filenam for the specified user index 
was not dumped because a catalog read error 
affected the sector on which the file was 
cataloged. Error idle status is set for 
the device. 



Analyze error and try 
again. 



PFDUMP 



PFDUMP COMPLETED. 



PFDUMP - DAF READ ERROR, FM-family,DNdn, 
EQeq.Ttttt.Sssss. 



PFDUMP - DAF READ ERROR, FN-filenam, 
Ul-userin ,PRU-pru . 



PFDUMP - DAF READ ERROR, PN-packnam, 
EQeq.Ttttt.Sssss. 



PFDUMP - DAF TOO LONG,FM-family,DNdn,EQeq, 
Ttttt.Sssss. 



Marks normal termination of PFDUMP. No 
further processing occurs after this message 
is issued. 

A mass storage error occurred while PFDUMP 
read a direct access file on the specified 
family, device number, equipment number, 
logical track, and logical sector. The dump 
continues with the next record, unless 
suppressed by the error option. 

A mass storage error occurred while PFDUMP 
read direct access file filenam for user 
index userin at relative PRU pru. The dump 
continues at the next record, unless 
suppressed by the error option. 

A mass storage error occurred while PFDUMP 
read a direct access file on the specified 
auxiliary pack. The equipment number, 
logical track, and logical sector are given. 
The dump continues with the next record, 
unless suppressed by the error option. 

A direct access file was truncated at the 
specified, family, device, equipment number, 
logical track, and sector when the number 
of sectors read for the file exceeded the 
length determined from the TRT. Dumping 
continues with the next file. Error idle 
status is set for the device. 



None. 



Analyze error and try 
again . 



Analyze error and try 
again. 



Analyze error and try 
again. 



Dump files, initialize 
device, and reload 
files. 



PFDUMP 



PFDUMP 



PFDUMP 



PFDUMP 



PFDUMP 



PFDUMP 



DAF TOO LONG, FN-filenam, Ul-userin, 
PRU-pru. 



Direct access file filenam for user index 
userin was truncated at the specified 
relative PRU address when the number of 
sectors read for the file exceeded the 
length determined from the TRT. Dumping 
continues with the next file. Error idle 
status is set for the device. 



Dump files, initialize 
device, and reload 
files. 



PFDUMP 



PFDUMP - DAF TOO LONG, PN-packnam, EQeq, 
Ttttt,Sssss. 



a 



A direct access file on the specified 
auxiliary pack was truncated at the 
specified equipment number, logical track, 
and logical sector when the number of 
sectors read for the file exceeded the 
length determined from the TRT. Dumping 
continues with the next file. Error idle 
status is set for the device. 



Dump files, initialize 
device, and reload 
files. 



PFDUMP 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



O 



PFDUMP - DAF TOO SHORT, FM=family, 
DNdn,EQeq,Ttttt,Sssss. 



The number of sectors dumped for a direct 
access file. on the specified family device 
with the specified equipment number, logical 
track, and sector was less than the length 
determined by the TRT. Dumping continues 



Dump files, initialize 
device, and reload 
files. 



PFDUMP 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



M 



PFDUMP - DAF TOO SHORT, FN- filenam, 
UI-userin,PRU=pru. 



set for the device. 

The number of sectors dumped for the 
specified direct access file was less than 
the length determined from the TRT. Dumping 
continues with the next file. Error idle 
status is set for the device. 



Dump files, initialize 
device, and reload 
files. 



PFDUMP 



PFDUMP - DAF TOO SHORT, PN-packnam, 
EQeq,Ttttt,Sssss. 



The number of sectors dumped for a direct 
access file on the specified auxiliary pack 
at the specified equipment number, logical 
track, and sector was less than the length 
determined from the TRT. Dumping continues 
with the next file. Error idle status is set 
for the device. 



Dump files, initialize 
device, and reload 
files. 



PFDUMP 



PFDUMP - DAF TRUNCATED, FN-filenam, 
UI=userin,PRU-pru. 



PFDUMP - DEVICE ERROR IDLE SET,FM-family, 
DNdn,EQeq,Ttttt,Sssss. 



Direct access file filenam was truncated 
when a mass storage error occurred prevent- 
ing further dumping of the file. PRU-pru 
gives the number of PRUs truncated. 

PFDUMP has set an error idle status on 
device dn, equipment eq for the reason 
given in the message issued just prior to 
this one. 



Analyze error and try 
again. 



Dump fles, initialize 
device, and reload 
files. 



PFDUMP 



PFDUMP 



PFDUMP DEVICE dn FAMILY family. 



PFDUMP DEVICE MASK dm. 



PFDUMP - DEVICE dn NOT FOUND. 



PFDUMP - DEVICE NOT FOUND, FN=filenam, 
UI-userin,DNdn. 



PFDUMP DEVICE dn PACK packnam. 



Informative message identifying the device 
being dumped, and the family name associated 
with that device. 

dn Device number 

family Family name 

Informative message indicating device mask 
(dm) of device currently being dumped. 

The dump aborted because the specified 
device was not found. 



The dump aborted because device dn 
containing file filenam for user index 
userin was not found. 

Informative message identifying the pack 
name of the auxiliary device currently being 
dumped . 

dn Device number 

packnam Pack name 



None. 



None. 



Retry operation with 
device defined in the 
system. 

Retry operation with 
device defined in the 
system. 

None. 



PFDUMP 



PFDUMP 



PFDUMP 



PFDUMP 



PFDUMP 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



PFDUMP - IAF READ ERROR, FM-f amily.DNdn, 
EQeq.Ttttt.Sssss. 



PFDUMP - IAF READ ERROR, FN-filenam, 
UI-userin,PRU-pru. 



PFDUMP - IAF READ ERROR, PN-packnam,EQeq, 
Ttttt.Sssss. 



PFDUMP - IAF TOO LONG, FM-f amily.DNdn, EQeq, 

Ttttt,SS88S. 



A mass storage error occurred while PFDUMP 
read an indirect access file on the 
specified family, device number, equipment 
number, logical track, and logical sector. 
Dumping continues with the next record, 
unless suppressed by the error option. 

A mass storage error occurred while PFDUMP 
read indirect access file filenam for user 
index userin at relative PRU pru. Dumping 
continues with the next record, unless 
suppressed by the error option. 

A mass storage error occurred while PFDUMP 
read an indirect access file on the 
specified auxiliary pack. The equipment num- 
ber logical track, and logical sector are 
given. Dumping continues with the next rec- 
ord, unless suppressed by the error option. 

An indirect access file was truncated at 
the specified, family, device, equipment 
number, logical track, and sector when the 
number of sectors read for the file exceeded 
the length determined from the TRT. Dumping 
continues with the next file. Error idle 
status is set for the device. 



Analyze error and try 
again . 



Analyze error and try 
again. 



Analyze error and try 
again. 



Dump files, initialize 
device, and reload 
files. • 



PFDUMP 



PFDUMP 



PFDUMP 



PFDUMP 



PFDUMP - IAF TOO LONG,FN-f ilenam.UI-userin, 
PRU-pru. 



An indirect access file filenam for user 
index userin was truncated at the specified 
relative PRU address when the number of 
sectors read for the file exceeded the 
length determined from the TRT. Dumping 
continues with the next file. Error idle 
status is set for the device. 



Dump files, initialize 
device, and reload 
files. 



PFDUMP 



PFDUMP - IAF TOO LONG,PN-packnam,EQeq, 
Ttttt.Sssss. 



PFDUMP - IAF TOO SHORT, FM-f amily, 
DNdn, EQeq.Ttttt.Sssss. 



An indirect access file on the specified 
auxiliary pack was truncated at the 
specified equipment number, logical track, 
and logical sector when the number of 
sectors read for the file exceeded the 
length determined from the TRT. Dumping 
continues with the next file. Error idle 
status is set for the device. 

The number of sectors dumped for an indirect 
access file on the specified family device 
at the specified equipment number, logical 
track and sector was less than the length 
determined by the TRT. Dumping continues 
with the next file. Error idle status is 



Dump files, initialize 
device, and reload 
files. 



PFDUMP 



Dump files, initialize 
device, and reload 
files. 



PFDUMP 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



Q 



PFDUMP - IAF TOO SHORT, FN=filenam, 
UI-userin,PRU-pru. 



PFDUMP - IAF TOO SHORT, PN-packnam, 
EQeq,Ttttt,Sss33. 



PFDUMP - IAF TRUNCATED, FN-filenam, 
UI-userin,PRU=pru. 



PFDUMP - MSS FUNCTIONS SUPPRESSED. 



PFDUMP - MSS STAGED FILE RESCAN KILLED, 
FN"f ilenam, Ul-userin. 



PFDUMP - NO FILES PROCESSED. 



PFDUMP - NO FILES SELECTED. 



PFDUMP - OPERATOR DISABLED filenam. 



set for the device. 

The number of sectors dumped for the 
specified indirect access file was less 
than the length determined from the TRT. 
Dumping continues with the next file. Error 
idle status is set for the device. 

The number of sectors dumped for an indirect 
access file on the specified auxiliary pack 
at the specified equipment number, logical 
track, and sector was less than the length 
determined from the TRT. Dumping continues 
with the next file. Error idle status is 
set for the device. 

Indirect access file filenam for user index 
userin was truncated when a mass storage 
error occurred preventing further dumping of 
the files. PRU=pru gives the number of PRUs 
truncated. 

PFDUMP has discontinued all functions 
relating to MSS processing (in particular, 
file staging) because of an error noted in 
a previous message. This message is 
issued whenever an error idle status is set 
for a device. 

The operator discontinued the rescan of a 
given catalog track for MSF files staged to 
disk and newly linked to their catalog 
entries. Probable cause of the operator's 
action is a malfunction of MSSEXEC and/or 
its auxiliaries. This message is issued 
for each file not dumped because of the 
operator's action. After all such files are 
listed, dumping continues with the next 
catalog track. 

Informative message indicating that no files 
have been dumped. 



The dump aborted because the specified file 
selection parameters for the dump were such 
that the files could not exist on the 
system. 

The PFDUMP archive or verify file named was 
disabled by operator action. The dump 
continues on the remaining file. 



Dump files, initialize 
device, and reload 
files. 



Dump files, initialize 
device, and reload 
files. 



Analyze error and try 
again. 



If MSS-related functions 
are desired, try again 
after fixing the error. 



Analyze reason for 
operator's action and 
try again. 



PFDUMP 



PFDUMP 



PFDUMP 



PFDUMP 



PFDUMP 



Check file selection 
parameters and rerun if 
necessary. 

Change file selection 
parameters and restart 
dump. 



None. 



PFDUMP 



PFDUMP 



PFDUMP 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



PFDUMF - ORPHAN PFC ENCOUNTERED, FN-filenam, 
UI=userin. 



PFDUMP - PERMIT FORMAT ERROR, FN-filenam, 
Ul-userin. 



PFDUMP - PERMIT READ ERROR , FM-family , 
DNdn,EQeq,Ttttt,Sssss. 



PFDUMP - PERMIT READ ERROR, FN-filenam, 
Ul-userin. 



PFDUMP - PERMIT READ ERROR, PN-packn am, 
EQeq,Ttttt,Ssss8. 



File filenam does not have an image on disk 
or on MSF. Error idle status is set for 
the device. Dumping continues with the next 
file. 

The permit entries for the specified file 
were not dumped because the user index did 
not match the specified user index. Dumping 
continues with the file data. Error idle 
status is set for the device. 

A mass storage error occurred while PFDUMP 
read permit information on the specified 
family, device number, equipment number, 
logical track, and logical sector. The bad 
sector and any following sectors of permit 
information for the affected user index are 
truncated. Dumping continues with the file 
data. Error idle status is set for the 
device. 

A mass storage error occurred while PFDUMP 
read the permit information of file filenam 
for user index userin. The bad sector and 
any following sectors of permit information 
for user Index userin are truncated. Dump- 
ing continues with the file data. Error 
idle status is set for the device. 

A mass storage error occurred while PFDUMP 
read permit information on the specified 
auxiliary pack. The equipment number, 
logical track and logical sector are given. 
The bad sector and any following sectors of 
permit information for the affected user 
index are truncated. Dumping continues 
with the file data. Error idle status is 
set for the device. 



Analyze error and then 
purge the affected file- 



Recreate the permit 
entries for the file. 



Analyze error and try 
again . 



PFDUMP 



PFDUMP 



PFDUMP 



Analyze error and try 
again. 



PFDUMP 



Analyze error and try 
again. 



PFDUMP 



PFDUMP - PFC ONLY FILE DETECTED, FN-filenam, 
Ul-userin. 



PFDUMP - PFC/PERMITS ONLY, FN-filenam, 
Ul-userin. 



A permanent file catalog entry was detected None. 

for a file residing on a secondary mass 

storage device. Secondary mass storage 

devices are not supported by this system. 

The file is not dumped. Dumping continues 

with the next file. 

Informative message indicating that only the None. 
PFC entry and permit information (not the 
file data) for file filenam were dumped. 



PFDUMP 



PFDUMP 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



M 



PFDUMP - RD/WT ERROR ON UCAT UPDATE, 
FN"f ilenam,UI«userin. 



An unrecoverable read/write error occurred 
while PFDUMP attempted to update the 
utility control date and time field in the 
PFC entry for file filenam. Error idle 
status is set for the device. Dumping 
continues with the next file. 



Dump the affected device 
and reload its files. 
PFLOAD will flaw the 
affected catalog track. 



PFDUMP 



PFDUMP - READ ERROR ON REQS - ABORT. 



There is an unrecoverable read error on the 
staging request file REQS. Thus, PFDUMP is 
not able to report the files not dumped 
because the operator suspended the rescan 
of a given catalog track for MSF files 
staged to disk and newly linked to their 
catalog entries. 



Analyze error and try 
again. 



PFDUMP 



PFDUMP - READ ERROR ON RESS - ABORT. 



There is an unrecoverable read error on the 
rescan screen file RESS. Thus, PFDUMP was 
not able to search for MSF files staged to 
disk and newly linked to their catalog 
entries. 



Analyze error and try 
again. 



PFDUMP 



PFDUMP - VERIFY ERROR ON UCDT UPDATE, 
FN»f ilenam,UI"userin. 



PFU has rejected the request to update the 
utility control date and time field in the 
PFC entry for file filenam. The catalog 
entry found at the indicated catalog track 
location did not agree with the supplied 
verification information. Error idle status 
is set for the device. Dumping continues 
with the next file. 



Dump affected device and 
reload its files. 



PFDUMP 



PFDUMP - ZERO FILE LENGTH filenam user in. 



PFLOAD ABORTED. 



File filenam is empty and thus cannot be 
dumped. Dumping continues with the next 
file. This is a nonfatal system error. 

A fatal error occurred causing PFLOAD to 
abort. 



None. 



Check dayfile for other 
error messages to aid in 
determining the cause of 
the abort. 



PFDUMP 



PFLOAD 



PFLOAD - ARCHIVE FILE FORMAT ERROR. 



Information not recognizable by PFLOAD was 
detected on the archive file. Loading 
continues with the next file. 



Ensure correct tape is 
in use and/or retry 
operation. 



PFLOAD 



PFLOAD - ASSIGN TAPE. 



PFLOAD - CATALOG IMAGE FORMAT ERROR. 



Informs operator that assignment of archive 
file is required. 

The load aborted because a catalog image 
record was found on the archive file in a 
format unrecognizable by PFLOAD. 



Assign archive file. 



The bad archive file 
can be used in a normal 
load by specifying the 
omit option (0P=0) to 
skip the catalog image 



PFLOAD 



PFLOAD 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



PFLOAD - CATALOG READ ERROR, FM-family, 
DNdn,CTct,EQeq,Ttttt,Sssss. 



A mass storage error occurred while PFLOAD 
read catalog Information on the specified 
family, device number, logical catalog track, 
equipment number, logical track, and logical 
sector. Error idle status is set for the 
device. 



record. 

Analyze error and try 
again. 



PFLOAD 



PFLOAD - CATALOG READ ERROR, FN-filenam, 
Ul-userin. 



File filenam was cataloged in a sector 
affected by a mass storage error. Error 
idle status is set for the master device. 



Analyze error and try 
again. 



PFLOAD 



PFLOAD - CATALOG READ ERROR, PN-packnam, 
EQeq.Ttttt.Sssss. 



A mass storage error occurred while PFLOAD 
read catalog information on the specified 
auxiliary pack. The equipment number, 
logical track, and logical sector are given. 
Error idle status is set for the device. 



Analyze error and try 
again. 



PFLOAD 



PFLOAD - CATALOG WRITE ERROR, FM-family, 
DNdn,CTct,EQeq,Ttttt,Sssss. 



A mass storage error occurred while PFLOAD 
wrote catalog information on the specified 
family, device number, logical catalog track, 
equipment number, logical track, and logical 
sector. Error idle status is set for the 
device. 



Analyze error and try 
again. 



PFLOAD 



PFLOAD - CATALOG WRITE ERROR, FN-filenam, 
Ul-userin. 



PFLOAD - CATALOG WRITE ERROR, PN-packnam, 
EQeq,Ttttt,Sssss. 



PFLOAD - DAF WRITE ERROR, FM-family, DNdn, 
EQeq,Ttttt,Sssss. 



PFLOAD - DAF WRITE ERROR, FN-filenam, 
Ul-userin. 



The catalog information for file filenam 
could not be written because of a mass 
storage write error. Error idle status 
is set for the master device. 

A mass storage error occurred while writing 
catalog information on the specified 
auxiliary pack. The equipment number, 
logical track, and logical sector are given. 
Error idle status is set for the device. 

A mass storage error occurred while PFLOAD 
wrote a direct access file on the specified 
family, device number, equipment number, 
logical track, and logical sector. Mass 
storage space for the affected file is 
dropped and the bad track is flawed. A 
catalog entry is not created for the file. 
Loading continues with the next file. 

A mass storage error occurred while PFLOAD 
wrote direct access file filenam for user 
index user in. Mass storage space for the 
affected file is dropped and the bad track is 
flawed A catalog entry Is not created for 
the file. Loading continues with the next 



Analyze error and try 
again. 



Analyze error and try 
again. 



Analyze error and try 
again. 



PFLOAD 



PFLOAD 



PFLOAD 



Analyze error and try 
again. 



PFLOAD 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



file. 



O PFLOAD - DAF WRITE ERROR, PN-packnam, 

EQeq,Ttttt,Sssss. 



PFLOAD DEVICE dn FAMILY family. 



PFLOAD - DEVICE dn NOT FOUND. 



PFLOAD DEVICE dn PACK packnam. 



PFLOAD - ERROR IDLE DETECTED, FM=family,DNdn, 
EQeq,Ttttt,Sssss. 



PFLOAD - ERROR IDLE DETECTED, FN-filenam, 
UI«userin. 



PFLOAD - ERROR IDLE DETECTED, PN-packnam, 
EQeq,Ttttt,Sssss. 



PFLOAD - ERROR IDLE SET,FM-family,DNdn, 
EQeq,Ttttt,Sssss. 



PFLOAD - EXCESSIVE PARITY ERRORS. 



A mass storage error occurred while PFLOAD 
wrote a direct access file on the specified 
auxiliary pack. The equipment number, 
logical track, and logical sector are given. 
Mass storage space for the affected file is 
dropped and the bad track is flawed. A 
catalog entry is not created for the file. 
Loading continues with the next file. 

Informative message identifying the device 
being loaded and the family name associated 
with that device. 

dn Device number 

family Family name 

The load aborted because the specified 
device was not found. 



Informative message identifying the pack 
name of the auxiliary device being loaded 
The device number will always be zero. 

dn Device number 

packnam Pack name 

The load aborted because an error idle 
condition was detected on the specified 
family device. The equipment number, logical 
track, and logical sector are given. 

The load aborted because an error idle 
condition was detected on the permanent 
file device being loaded. The file filenam 
is the first file that could not be loaded. 

The load aborted because an error idle 
condition was detected on the specified 
auxiliary device. The equipment number, 
logical track, and logical sector are given. 

PFLOAD has set an error idle status on 
device dn, equipment eq for the reason 
given in the message issued just prior to 
this one. 



Analyze error and try 
as»ain. 



PFLOAD 



PFLOAD has encountered 100B consecutive 
read parity errors on the archive file, 
load is aborted. 



The 



None. 



Retry operation with 
device defined in the 
system. 

None. 



Correct error idle 
condition and then rerun 
the load. 



Correct error idle 
condition and then rerun 
the load. 



Correct error idle 
condition and then rerun 
the load. 



Analyze error and try 
again. 



Rerun the load using 
another archive file. 



PFLOAD 



PFLOAD 



PFLOAD 



PFLOAD 



PFLOAD 



PFLOAD 



PFLOAD 



PFLOAD 



PFLOAD - EXTRACT ILLEGAL WITHOUT CIR. 



The load aborted because the extract option 
was specified for the load when the archive 
file did not contain a catalog image record 
(CIR) . 



Retry without extract 
option. 



PFLOAD 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



PFLOAD - IAF WRITE ERROR, FM-family,DNdn, 
EQeq,Ttttt,Sssss. 



PFLOAD - IAF WRITE ERROR, FN-filenam, 
Ul-userin. 



A mass storage error occurred while PFLOAD 
wrote an indirect access file on the 
specified family, device number, equipment 
number, logical track, and logical sector. 1 
catalog entry with a special write error 
user index is created for that portion of 
the file up to and including the bad sector. 
Loading continues with the next file. 

A mass storage error occurred while PFLOAD 
wrote indirect access file filenam for user 
user userin. A catalog entry with a special 
write error user index is created for that 
portion of the file up to and including the 
bad sector. Loading continues with the next 
file. 



Analyze error and try 
again. 



PFLOAD 



Analyze error and try 
again. 



PFLOAD 



PFLOAD - IAF WRITE ERROR, PN«packnam,EQeq, 
Ttttt,Sssss. 



PFLOAD - ILLEGAL NAME/ INDEX, 000000 
filenam userin. 



A mass storage error occurred while PFLOAD 
wrote an indirect access file on the speci- 
fied auxiliary pack. The equipment number, 
logical track, and logical sector are given. 
A catalog entry with a special write error 
user index is created for that portion of 
the file up to and including the bad sector. 
Loading continues with the next file. 

A file with an illegal name and/or user 
index was encountered and skipped. The 
42-bit file name and 18-bit user index are 
shown in octal. Loading continues with the 
next file. 



Analyze error and try 
again. 



PFLOAD 



Analyze error and 
try again. 



PFLOAD 



PFLOAD - LABEL BAD, ASSIGN NEW TAPE. 



Informs operator that the archive file did 
not contain a correct dump label. 



Assign a new archive 
file. 



PFLOAD 



PFLOAD - NO FILES SELECTED. 



PFLOAD - PARITY ERR filenam userin. 



PFLOAD - PERMIT WRITE ERROR , FM-family , 
DNdn,EQeq,Ttttt,Sssss. 



The load aborted because the file selection 
parameters for the load were such that the 
specified files could not exist in the 
system. 

Parity error was encountered on tape while 
PFLOAD loaded file filenam; file is skipped. 
This is a nonfatal system error. 

A mass storage error occurred while PFLOAD 
wrote permit information on the specified 
family, device number, equipment number, 
logical track, and logical sector. The bad 
sector and any following sectors of permit 
information for the affected user index are 
truncated. Error idle status is set for 



Correct selection 
parameters and 
restart load. 



Retry or use backup tape. 



Analyze error and try 
again. 



PFLOAD 



PFLOAD 



PFLOAD 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



the device. 



PFLOAD - PERMIT WRITE ERROR, FN- filenam, 
Ul-userin. 



PFLOAD - PERMIT WRITE ERROR, PN-packnam, 
EQeq,Ttttt,Sssss. 



PFLOAD - PFC/PERMITS ONLY LOADED, 
FN-f ilenam, Ul-userin. 



PFLOAD - SELECTED FILES NOT ON ARCHIVE FILE. 



PFLOAD - STATUS ERR filenam user in. 



A mass storage error occurred while PFLOAD 
wrote the permit information of file filenam 
for user index user in. The bad sector and 
any following sectors of permit information 
for user index userin are truncated. Error 
idle status is set for the device. 

A mass storage error occurred while PFLOAD 
wrote permit information on the specified 
auxiliary pack. The equipment number, 
logical track and logical sector are given. 
The bad sector and any following sectors of 
permit information for the affected user 
index are truncated. Error idle status 
is set for the device. 

Informative message indicating that only 
the PFC entry and permit information for 
file filenam were loaded. The file data was 
not available on the archive file. It is 
assumed that the file data resides on the 
Mass Storage Facility. 

The load aborted because the archive file 
dump label showed that the selected files 
are not on the archive file. 



Device on which direct access file filenam 
is to be loaded is not available; file 
is skipped. This is a nonfatal system 
error. 



Analyze error and try 
again. 



Analyze error and try 
again. 



PFLOAD 



PFLOAD 



None. 



PFLOAD 



Ensure correct archive 
tape is being used and 
that correct PFLOAD 
parameters are specified 
and retry operation. 

Make device available 
and retry. 



PFLOAD 



PFLOAD 



PFLOAD - SYSTEM SECTOR TOO LONG, FN-f ilenam, 
Ul-userin. 



PFLOAD - SYSTEM SECTOR TRUNCATED, 
FN-f ilenam, Ul-userin. 



The word count for the system sector 
encountered for file filenam exceeds the 
standard length; probable cause is that 
two parts of different split system sectors 
were joined. File filenam is skipped. 
Loading continues with the next file. 

The word count for the system sector 
encountered for file filenam is less than 
the standard length; probable cause is that 
part of a split system sector is missing. 
File filenam is skipped. Loading continues 
with the next file. 



Analyze error and try 
again, or use backup 
tape. 



Analyze error and try 
again . 



PFLOAD 



PFLOAD 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



PFLOAD - TAPE ERROR filenam userin. 



Error was encountered on tape while PFLOAD 
loaded file filenam; file is skipped. This 
is a nonfatal system error and is similar 
to the PFLOAD - PARITY ERR filenam userin. 
message in that the data read from the 
archive tape is not logically sound. 



Inform site analyst. 



PFLOAD 



PFLOAD - TRACK LIMIT, FM-family,DNdn,EQeq, 
Ttttt.Sssss. 



The load aborted because a track limit 
condition was encountered on the specified 
family device. The equipment number 
logical track, and logical sector are given. 



Free up space on the 
device and then rerun 
the load. 



PFLOAD 



PFLOAD - TRACK LIMIT, FN-filenam, Ul-userin. 



The load aborted because a track limit 
condition was encountered on the permanent 
file device being loaded. The file filenam 
is the first file that could not be loaded. 



Free up space on the 
device and then rerun 
the load. 



PFLOAD 



PFLOAD - TRACK LIMIT, PN-packnam,EQeq,Ttttt, 
Sssss. 



PFN-filenam, FAMILY-family, Ul-userin - 
ALREADY PERMANENT. 



The load aborted because a track limit 
condition was encountered on the specified 
auxiliary device. The equipment number, 
logical track, and logical sector are given. 

One or more of the CSU maps and/or MSF 
catalogs to be created already exists. 



Free up space on the 
device and then rerun 
the load. 



Correct parameters on 
the ASDEF control 
statement and retry, 
or purge the existing 
MSF catalogs and/or 
CSU maps and retry. 



PFLOAD 



ASDEF 



PFN-filenam, FAMILY-family, Ul-userin 
CIO ERROR. 



A write error was encountered on the CSU map 
or the MSF catalog. 



Purge the affected 
CSU map or MSF catalog 
and use ASDEF to create 



a new one. 



ASDEF 



PFN-filenam, FAMILY-family Ul-userin 
DEFINE ERROR. 



PFN-filenam, FAMILY-family, Ul-userin 
FAMILY NOT FOUND. 

PFN-filenam, FAMILY-family, Ul-userin 
FILE INITIALIZED. 



PFU - ALTERNATE DEVICE NOT FOUND. 



ASDEF cannot define a CSU map or MSF 
catalog. 



The family specified by the FM parameter on 
the ASDEF control statement does not exist. 

Informative message indicating that the 
CSU map or MSF catalog was created 
successfully. 

PFU is unable to locate the alternate device 
access file which does not reside on a 
master device. 



Submit a Programming 
System Report (PSR) with 
supporting material. 

Specify an existing 
family and retry. 

None. 



Make device available 
and retry. 



ASDEF 



ASDEF 



ASDEF 



PFU 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



PFU - BUFFER ARGUMENT ERROR ON lfn AT addr. 



•n 



The circular buffer pointers for file lfn 
did not satisfy the following conditions. 

- FIRST .LE. IN .LT. LIMIT 

- FIRST .LE. OUT .LT. LIMIT 

- LIMIT .LE. FL 

The FET address is addr. This message 
should not occur unless there is an error in 
the utility or someone is writing into the 
utility's field length. Dayfile message. 



Analyze error and 
try again. 



PFU 



PFU - BUFFER CTL WORD ERROR ON lfn AT addr. 



The word count of a disk sector to be read 
from a central memory buffer exceeds the 
word count limit of a sector (100B). This 
usually indicates an internal error in 
PFLOAD. Dayfile message. 

lfn Name of file being processed 

addr FET address of file 



Inform site analyst. 



PFU 



PFU - CATALOG TRACK NOT FOUND. 



No permanent file catalog track could be 
found for the user index being processed. 
Dayfile message. 



Inform site analyst. 



PFU 



PFU - CONTROL POINT ERROR FLAG DETECTED 
ffff. 



Error flag ffff was detected at PFU control 
point; PFU aborts. If no operator action 
has been taken to drop the control point, 
other messages indicating the probable 
cause of the error flag should be present. 
Dayfile message. 



Inform site analyst, 
if operator did not 
drop the control point. 



PFU 



PFU - DUPLICATE FILE, lfn AT addr. 



There is a file at the control point whose 
name, lfn, is the same as one of the files 
used by the permanent file utility that is 
currently active, addr is the address of 
the file's FET. Dayfile message. 



Inform site analyst; 
recommended action is to 
return or rename the 
file and retry. 



PFU 



PFU - FILE NOT FOUND, lfn AT addr. 



An entry for the file lfn was not found in 
the file name table (FNT) . This usually 
indicates an internal error in one of the 
permanent file utility processors (PFCAT, 
PFCOPY, PFDUMP, or PFLOAD). addr is the 
address of the file's FET. Dayfile message. 



Inform site analyst. 



PFU 



PFU - I/O SEQUENCE ERROR ON lfn AT addr. 



An operation was requested on a file before 
the previous operation completed. This 
usually indicates an internal error in one 
of the permanent file utility processors 
(PFCAT, PFCOPY, PFDUMP, or PFLOAD). 
Dayfile message. 

lfn Name of file being processed 

addr FET address of file 



Inform site analyst. 



PFU 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



PFU - NO DEVICE SPECIFIED. 



PFU - NOT SYSTEM JOB. 



PFU - PARAMETER ERROR. 



PFU - TRACK FLAWED, EQeq.Ttttt. 



PFU - TRACK INTERLOCK CLEAR ON lfn AT addr. 



No device number was specified with the PFU 
read list function, probably as a result of 
an internal error in PFDUMP. 

The calling program is a nonsystem origin 
job and it does not have system origin 
privileges with the console in DEBUG mode. 
Dayfile message. 



The program calling PFU has an error in 
the calling parameters. This should not 
occur unless there is an error in the 
utility or a nonutility program is calling 
PFU. Nonutility programs call PFU at their 
own risk. Dayfile message. 

Flawed track was found on equipment eq, 
logical track tttt. 

When PFU was called to clear the track 
interlock on a file, the FST entry for that 
file showed that the interlock was already 
clear. This usually indicates an internal 
error in PFDUMP. Dayfile message. 

lfn Name of file being processed 

addr FET address of file 



Analyze error and 
try again. 



If the utility is 
running as a nonsystem 
job with system origin 
privileges, ensure that 
the console is in DEBUG 
mode. 

Inform site analyst. 



PFU 



PFU 



PFU 



Hardware error. Contact 
customer engineer. 

Inform site analyst. 



PFU 



PFU 



PFU - TRACK INTERLOCK SET ON lfn AT addr. 



When PFU was called to set the track inter- 
lock on a file, the FST entry for that file 
showed that the interlock was already set. 
This usually indicates an internal error 
in PFDUMP. Dayfile message. 

lfn Name of file being processed 

addr FET address of file 



Inform site analyst. 



PFU 



PK, PT OPTION VIOLATED. 



*PN* DESIGNATION MUST PRECEDE *PL*. 



One of the following. 

- The PK or PT option cannot be used with 
the directive specified. 

- The PK or PT option has not been 
specified correctly. 

- The PK or PT option cannot be used with 
one of the other parameters specified. 

Output file message indicating that the PN 
parameter was specified after the PL 
parameter. 



Correct the error 
and retry. 



ASLABEL 



Correct and rerun. 



VALNET 



^ 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



M 



POLLING CODE OUT OF RANGE. 



PORT LIMIT OUT OF RANGE. 



PORT NUMBER OUT OF RANGE. 



PORT NUMBER UNDEFINED FOR PREVIOUS TERMINAL. 



Output file message indicating that the 
polling code specified was not within 
the range of through 77777777B. 

Output file message indicating that the port 
limit specified was not between PN+1 and 15 
(6671 multiplexer), PN+1 and 63 (6676 
multiplexer), or PN+1 and 1022 (stimulated 
multiplexer) . 

Output file message indicating that the port 
number specified was not between 1 and 1 6 
(6671 multiplexer), 1 and 64 (6676 multi- 
plexer) , or 1 and 4096 (stimulated multi- 
plexer) . 

Output file message indicating that the port 
number was not specified on the previous 
terminal definition directive. This is 
required for //STIM, //6671, and //6676 
directives. 



Correct and rerun. 



Correct and rerun. 



Correct and rerun » 



Correct and rerun. 



VALNET 



VALNET 



VALNET 



VALNET 



PPU NOT FOUND. 



Output file message indicating that the 
requested PP record was not found in the 
EDD file. 



Ensure that the dump file 
contains meaningful 
information. 



DSDI 



PREMATURE END OF FILE. 



During processing of the dump tape, an EOF 
was detected before the end of the dump 
control word. 



Inform site analyst. 
Format of the dump tape 
should be investigated. 



PFATC 



PREMATURE END OF FILE. 



PREMATURE *E0F* ENCOUNTERED. 



Either the CCP tape is empty or the tape 
description card specified more files than 
were physically present on the CCP tape. 

During processing of the load file, an EOF 
was encountered before it was expected. 



Correct the error 
and try again. 



Inform site analyst. 
Format of the load tape 
should be investigated. 



LFG 



QLOAD 



PREVIOUS KTS TERMINAL MAY NOT SPECIFY 
PORT RANGE. 



PRIVATE PACK/PERMIT UN CONFLICT. 



Output file message indicating that a port 
range was specified on a TRANEX terminal 
definition directive. PL is an illegal 
argument for a TRANEX terminal. 

User number of the private pack is not the 
same as the user number specified for 
permits. In this case, no new active 
dayfiles may be started on the private 
pack. 



Correct and rerun. 



Select a different device 
for the new dayfile. 



VALNET 



DFTERM 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



PROCESSING COMPLETE ON DMPAdmp. 



PROCESSING DUMP FILE. 

dmp yy/mm/dd. hh.mm.ss. 



PROFILE ABORTED. 



PROFILE FILE CREATE COMPLETE. 



PROFILE FILE DATA BASE ERROR. 



PROFILE FILE INQUIRY COMPLETE. 



PROFILE FILE INTERLOCKED. 



This message appears for each output 
processed. 

Informative message indicating which dump 
is currently being processed and the date 
and time. This message is issued when the 
dump header field is encountered. In 
cases where file positioning requests 
position the file beyond this point, the 
message will not appear. 

Dayfile message indicating that an error 
flag has been set at the control point. 



Dayfile message indicating that the creation 
run is complete. 

Dayfile message indicating that the project 
file does not contain both a level and 
level 1 block. 



Dayfile message indicating that the inquire 
run is complete. 

Message displayed at line 1 of the control 
point Indicating that the PROFILE file is 
interlocked for modification during update 
run. 



None. 



None. 



Consult dayfile listing 
for reason (operator 
drop, for example). 

None. 



Ensure that the project 
file is local and 
contains a level and 
level 1 block (at least 
one charge entry) and 
rerun. 

None. 



None. 



NDA 



QLOAD 



PROFILE 



PROFILE 



PROFILE 



PROFILE 



PROFILE 



PROFILE FILE LIST COMPLETE. 



PROFILE FILE REFORMAT COMPLETE. 



PROFILE FILE RELEASED. 



PROFILE FILE SOURCE COMPLETE. 



PROFILE FILE UPDATE COMPLETE. 



Dayfile message indicating that the list of None. 
PROFILa is complete. 

Dayfile message indicating that the reformat None, 
run is complete. 

Message displayed at line 1 of the control None, 
point indicating that the PROFILE file has 
been released during update run to allow 
other system updates. 

Dayfile message indicating that the source None, 
run is complete. 

Dayfile message indicating that the update None, 
run is complete. 



PROFILE 



PROFILE 



PROFILE 



PROFILE 



PROFILE 



w 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



en 



PROGRAM ABNORMAL, xxx. 



****PROJECT COUNT LIMIT EXCEEDED. 



****PROJECT NUMBER ACTIVE. 



****PROJECT NUMBER DOES NOT EXIST. 



There is a catalog access internal error in 
module xxx. 



Output file message indicating that the user 
has tried to create more active projects 
under this charge number than allowed. 

Output file message indicating that the user 
has attempted to activate an already active 
project number. 

Output file message indicating that a 
directive for which a project number must 
exist made reference to a project number 
that does not exist. 



Submit a Programming 
System Report (PSR) with 
supporting material. 

None. 



Rerun using correct 
project number, if 
necessary. 

Correct and rerun using 
existing project number. 



ASLABEL 



PROFILE 



PROFILE 



PROFILE 



****PROJECT NUMBER INACTIVE. 



PSEUDO MULTIPLEXER DESCRIPTION ERROR. 



PURGING filenam userin. 



Output file message indicating that the user 
has made a reference to a project number 
that is inactive with a directive for which 
the project number must be active. 

Output file message indicating that 
channel/ equipment information has been 
specified on a //DIAL multiplexer definition 
directive. 

Informative message indicating that file 
filenam is being purged after being dumped 
as directed by the purge after option. 



Activate project number 
and rerun or rerun using 
correct project number. 



Correct and rerun. 



None. 



PROFILE 



VALNET 



PFDUMP 



*Q* PARAMETER TOO LARGE - 
MAXIMUM ALLOWABLE VALUE SUBSTITUTED. 



Informative message. 



None. 



EXINIT 



*Q* PARAMETER TOO SMALL - 
MINIMUM ALLOWABLE VALUE SUBSTITUTED. 

QAC ERROR ENCOUNTERED. 



QALTER COMPLETE. 



QDUMP ABORTED. 



Informative message. 



Explanatory dayfile message indicating why 
FNTLIST or QALTER aborted. QAC returned an 
unexpected error code. 

Informative message indicating that QALTER 
operation is finished. 

An error has been detected which is not 
processed by QDUMP error processing. 
Attempts to correct the situation have been 
made, but discretion should be used in 
continuing use of QDUMP. 



None. 



Contact site analyst. 



None. 



Inform site analyst. 
Check the dayfile for 
other error messages to 
determine the cause of 
the abort. 



EXINIT 



FNTLIST 



FNTLIST 



QDUMP 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



QDUMP COMPLETE. 

QFM BUFFER TOO SMALL. 

QFM FILE ALREADY ATTACHED. 

QFM - FILE IGNORED filenam. 

QFM I/O SEQUENCE ERROR. 
QFM ILLEGAL REQUEST. 

QFM ILLEGAL USER ACCESS. 

QFM INTERLOCK ERROR. 
QFM RANDOM ADDRESS ERROR. 
QFM SYSTEM SECTOR ERROR. 
QFM TRACK MISMATCH. 

QFM UNABLE TO INTERLOCK MST. 
QLOAD ABORTED. 



Informative message indicating the specified 
operation has been completed. 

The buffer for reading the system sector is 
fewer than 100B words long. 

The specified file is already attached to 
the control point. 

The file was ignored because it had an 
illegal origin or type code. It could 
indicate a bad IQFT file. 

Action was requested on a busy file. 



One of the following. 

- Specified function was illegal or 
undefined 

- Job did not have SSJ- entry point 

- Auto recall bit was not set 

The user tried to perform an operation for 
which he is not validated (for example, 
attempting to run a system origin job from 
nonsystem origin. 



Track interlock could not be set because 
of conflict. 

An error occurred while the dayfile random 
address was being converted. 

An error occurred while the system sector 
was being read. 

The file about to be purged is not the same 
file that was previously attached. The first 
track in the FST does not equal the one from 
the DULL word. 

Informative message. 

Job was dropped by operator or aborted 
because of a system error. 



None. 



Increase the buffer size 
and retry. 

None. 



Verify that valid origin 
or file type code is 
being used. 

Wait until file is not 
busy and retry. 

Verify that valid QFM 
request is being made. 



Ensure accuracy of 
control statement or 
macro or determine 
proper validation 
requirements. 

Inform site analyst. 



Inform site analyst. 



Inform site analyst. 



Inform site analyst. 



None. 

Check the dayfile for 
other error messages to 
determine the cause of 
the abort. 



QDUMP 
QFM 
QFM 
QFM 

QFM 
QFM 

QFM 

QFM 
QFM 
QFM 
QFM 

QFM 
QLOAD 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



m 



QLOAD - mum ACTIVE FILES LOADED. 



QLOAD - nnnn ERRxxx FILES CREATED. 



Informative message indicating the number 
of active files loaded. 

Informative message indicating the number 
of queue files that could not be processed 
because of write parity errors on mass 
storage. The files in error have been 
renamed to the file ERRxxx and will remain 
assigned to the control point as locked 
common files . 



None. 



Inform site analyst to 
locate and flaw the 
tracks in error. 



QLOAD 
QLOAD 



QLOAD - nnnn FILES IGNORED. 



QLOAD - nnnn FILES LISTED. 



QLOAD - nnnn INACTIVE FILES LOADED. 



QLOAD OPERATION COMPLETE. 



QLOAD TERMINATED. 



QMOVE ABORTED. 



QMOVE COMPLETE. 



QREC COMPLETE. 



QREC/QLIST ABORTED. 



QUEUE FILE ASSIGN ERROR. 



Informative message indicating the number 
of files ignored during the load operation. 

Informative message indicating; the number 
of files listed. 

Informative message indicating the number 
of inactive files loaded. 

Informative message indicating completion 
of QLOAD. 

QLOAD aborted and the abort processing 
was terminated either by the operator or 
because of a system error. 

An error has been detected which is not 
processed by QMOVE error processing. 
Attempts to correct the situation have 
been made, but discretion should be used 
in continuing use of QMOVE. 

Informative message indicating completion 
of QMOVE. 

K-display message indicating completion 
of QREC. 

This message occurs if QREC aborts for any 
reason- 



Attempt to force a device assignment for 
the queue file being loaded resulted in 
the file being assigned to the wrong 
equipment . 



None. 



None. 



None. 



None. 



Check dayfile for the 
cause. 



Inform site analyst. 
Check the dayfile for 
other error messages to 
determine the cause of 
the abort. 

None. 



None. 



A level deadstart may 
be needed to recover 
lost queued files. 

Check output for files 
processed. 



QLOAD 
QLOAD 
QLOAD 
QLOAD 
QLOAD 

QMOVE 

QMOVE 

QREC 

QREC 

QLOAD 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



QUEUE FILE UTILITY COMPLETE. 



QUEUE STATUS INDEFINITE. 



QUEUED FILES LOST. 



QUEUES UNRECOVERABLE THIS DEVICE. 



Informative message indicating utility has 
completed. 

QREC, QDUMP, or QMOVE has not been able to 
finish necessary file processing after an 
error or error exit. The status of IQFTs 
and queued files is unknown. 

QREC lost some inactive queued files while 
attempting to requeue them. Files which 
process error conditions were not 
requested. This error should never occur 
but can occur if QREC was aborted and could 
not modify its files correctly. 

This message is issued in conjunction with 
the following message. 

DNdn FM family MS ERROR, (for QREC) 

or 
IQFT FILE ERROR DN dn FAMILY family, 
(for QDUMP /QMOVE) 



None. 



Inform site analyst. A 
level (initial) 
deadstart is recommended. 



A level deadstart is 
necessary to recover the 
lost queued files. 



None. 



QFSP 



QREC, 

QDUMP, 

QMOVE 



QREC 



QREC, 

QDUMP, 

QMOVE 



RD AND UI/UN NOT ALLOWED. 



RDF FILE ERROR - BAD RECORD LENGTH. 



Refer to the appropriate message for 
device information. 

The RD and IU/UN parameters in the PFDUMP 
control statement are mutually exclusive. 

The RF parameter specifies an invalid or 
wrong file, or there is an internal error in 
ASVAL or PFDUMP. The run is aborted. 



Correct, and retry. 



Correct the RF parameter 
and try again. 



PFS 



ASVAL 



RDF FILE ERROR - MISSING HEADER. 



The RF parameter specifies an invalid or 
wrong file, or there is an internal error in 
ASVAL or PFDUMP. The run is aborted. 



Correct the RF parameter 
and try again. 



ASVAL 



RDF FILE ERROR - UNIDENTIFIED DATA. 



Informative message indicating that a record 
type other than the known types was 
encountered. The run continues. 



Inform site analyst. 



ASVAL 



RDPFC, ERROR IDLE, DN dv. 



ASMOVE or ASVAL skipped device dv because of 
an error idle on the device. 



Clear the error idle and 
rerun ASMOVE or ASVAL. 



MAC2 



RDPFC, PF UTILITY ACTIVE, DN dv. 



ASMOVE or ASVAL skipped device dv because a 
permanent file utility was active on it. 



Rerun ASMOVE or ASVAL 
after the utility is 
done. 



MAC2 



O 



READ PARITY ERROR, 
filenam STAGING ERROR, JOB-jobnam, 
FM-family, Ul-userin, CSU-id, MST-n, 
VSN-vsn, ASA-addr, STRM-s. 



The staging of file filenam was aborted 
because of a read parity error. All jobs 
attempting to attach this file will be 
aborted or given an error response. 



Retrieve the file from 
a dump tape if a 
backup copy is 
available. Run ASVAL 
to identify other 
files, if any, that are 



MSSEXEC 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



M 



READ SECURITY OUT OF RANGE. 



READING filenam userin. 



RECORD NOT FOUND. 



RECORD NOT FOUND. 

*****RECORD SEQUENCING ERROR***** 
REFORMAT COMPLETE. 

RELEASE DATE USED = n. 

RELEASE TIME USED = n. 

REMOVABLE DEVICE /NO ACTIVE DAYFILES. 



REQUEST *K* DISPLAY, 



Output file message indicating that the data 
base read security was not in the range of 
to 7. 

Informative message indicating name of the 
file that is currently being read from the 
archive tape and the user index under which 
the file is stored. 

Error was encountered during the building of 
the system library. An attempt was made to 
place a nonexistent routine on an alternate 
system device. Deadstart processing halts 
when this error is detected. 

Output file message indicating that the 
record name specified in a READ directive 
was not found in the specified file. 

Dump file records are out of sequence. 

Dayfile message indicating reformat run 
successfully completed. 

Informative message indicating that the 
release date value used by ASMOVE is n. 

Informative message indicating that the 
release time value used by ASMOVE is n. 

The device specified by K-display 
parameters is a removable device and the 
option selected is termination of an 
active dayfile. Active dayfiles are not 
allowed to reside on removable devices. 

The K display is requested at the 
specified control point. This message 
appears in the comment field of a control 
point on the job status (B) display. 



affected by this error. 
Remove and reassign the 
cartridge. Refer to 
Error Conditions and 
Corrective Action in 
section 3. 

Correct and rerun. 



None. 



Attempt another dead- 
start. If the error 
persists, inform the 
site analyst. 



Correct and rerun. 

None. 
None. 

None. 

None. 



Enter new device using 
the K display. 



Enter command K,n. 

n Control point 
number 



VALNET 



PFCOPY, 
PFLOAD 



SYSEDIT 



DSD I 

NDA 
MODVAL 

ASMOVE 

ASMOVE 

DFTERM 



PFS, 
QFSP, 
MSI, 
MODVAL , 
PROFILE , 
MREC 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



REQUESTED MEMORY NOT FOUND. 



REQUESTED RESTORATIONS NOT FOUND. 



REQUIRED FL EXCEEDS JOB MAX. 



RESTORING ADDRESSES S/N=serialn. 



S/N MISMATCH - serialn JOB ABORTED. 



SCRIPTS CANNOT FOLLOW TASK DEFINITIONS. 



SDF INSTALLATION COMPLETE. 



SELECTED CUBE NOT ASSIGNED AS EXPECTED. 
NUMBER PROCESSED = n. 



SELECTED CUBE NOT EMPTY. 
NUMBER PROCESSED = n. 



SELECTED CUBE NOT UNASSIGNED. 
NUMBER PROCESSED = n. 



SELECTED DEVICE NOT MASS STORAGE. 



Ouput file message indicating that the EPB 
directive was entered and no ECS/PP buffer 
was found in the EDD file. 

The SYSEDIT value specified by the R 
parameter is greater than the current level. 



ASVAL needs more field length than allowed 
to complete processing. 



Console message indicating that the pack is 
currently undergoing restoration of the 
address fields. Here, serialn is the actual 
■pack serial number read. 

Console message indicating that FORMAT was 
terminated due to a mismatch between the 
serial number specified by the P parameter 
of the FORMAT control statement and the 
serial number recorded on the pack. Here, 
serialn is the serial number read from the 
pack. 

K-display message indicating that the format 
of the session file is incorrect; tasks must 
follow sessions. 

Informative message indicating that 
system deadstart file installation is 
complete. 

One of the cubicles is not available for the 
assignment specified by a directive to 
ASLABEL. However, n cubicles were assigned. 

One of the cubicles to be removed by the 
RB directive to ASLABEL is not empty. 
However, n cubicles were removed. 

One of the cubicles to be added by the AB 
directive to ASLABEL is already assigned. 
However, n cubicles were added. 

The equipment number specified on the MST 
directive was not the number of a mass 
storage device. 



Ensure that the dump file 
contains meaningful 
information. 

Correct the value 
specified by the R 
parameter to a value 
less than the current 
SYSEDIT change level. 

Increase the maximum 
field length for the 
job. 

Do not drop the control 
point while this message 
is displayed. 



Enter correct serial 
number with the P 
parameter of the FORMAT 
control statement. 



Put task definitions 
after session records. 



None. 



Correct the directive to 
ASLABEL and retry. 



Specify a different 
cubicle and retry. 



Specify a different 
cubicle and retry. 



Correct and rerun. 



DSDI 



SYSEDIT 



ASVAL 



FORMAT 



FORMAT 



STIMULA 



INSTALL 



ASLABEL 



ASLABEL 



ASLABEL 



DSDI 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



Q 



SELECTOR MOTION ERROR. 
DESTAGE RESTARTED. 



SEQUENCING BAD AFTER ADDRESS addr IN RECORD 
TYPE x. 



SETTING PF ACTIVITY COUNT. 



SETTING UTILITY INTERLOCK. 



*SL* NOT SPECIFIED CORRECTLY, 



SLVi ABNORMAL - xxx. 



A file destage operation was restarted 
using a different cartridge because of a 
hardware problem. 

Records of type x are not continuously 
located in ascending order on the dump file. 
This error occurred after line address addr. 

PFDUMP or PFCAT utility is waiting for PFU 
to increment the permanent file activity 
count before starting catalog processing. 
This message should be displayed for a 
few seconds only. 

PFLOAD utility is waiting for PFU to set 
the permanent file utility interlock on a 
device before loading it. When no other 
utility (such as PFLOAD or MSI) is active 
on the device and permanent file activity 
in the system ceases, PFLOAD continues 
automatically. 

The SL parameter on the ASUSE control 
statement was not a number from through 
16. 

MSSSLV on mainframe i has encountered an 
abnormal error condition in routine xxx. 



Inform customer 
engineer. 



Analyze error and 
try again. 



Inform site analyst if 
message is displayed for 
an extended period of 
time. 



Wait for other utility 
to complete. 



Correct the SL 
parameter and retry. 



Inform site analyst. 



EXDEST 



NDA 



PFDUMP 
PFCAT 



PFLOAD 



ASUSE 



MSSSLV 



SLVi ACTIVE, EXEC xxxx. 



SLVi - ERROR TERMINATION (1 ) , 



SLVi - IDLED DOWN. 



SLVi MTOSPFN xxxx. 



Informative message indicating the current 
status of MSSEXEC according to MSSSLV on 
mainframe i. 

While MSSSLV on mainfame i was reading the 
master-to-slave communications file MTOSPFN, 
an I/O error occurred which prevented 
further MSSSLV processing. 

Informative message indicating that MSSSLV 
on mainframe i terminated normally in 
response to an operator n.IDLE command. 

MSSSLV on mainframe i 
attempted to attach or 
read the master-to-slave 
communication file 
MTOSPFN. xxxx is the 
status of the attempt 
and is one of the 
following. 

OK 

ATTACH PROBLEM 

LENGTH PROBLEM 

NO MID MATCH 



None. 



Purge file MTOSPFN and 
reinitialize MSSEXEC and 
all MSSSLV programs. 



None. 



If xxxx is OK, no action 
is required. If xxxx is 
LENGTH PROBLEM, purge 
MTOSPFN and reinstall 
MSSSLV and MSSEXEC using 
identical values for 
NUMRB, MAXSLV, and 
NUMSLV in common deck 
COMEIPR and for RBSIZE 
in common deck COMASS • 
If xxxx is ATTACH 
PROBLEM or NO MID MATCH, 



MSSSLV 



MSSSLV 



MSSSLV 



MSSSLV 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



idle MSSEXEC (if 
currently running) , and 
reinitialize it. 



SLVi STOMNOi xxxx. 



ST NOT SPECIFIED CORRECTLY. 



STATUS /CONTROL REGISTERS NOT FOUND. 



STIMULATION COMPLETE. 



*SU* NOT SPECIFIED CORRECTLY. 



SUBSYSTEM NOT FOUND. 



SUPIO ERROR ec IN filenam ON READING 
RECORD x. 



O 



MSSSLV on mainframe i attempted to establish 
access to the slave-to-master communication 
file STOMNOi. The status of this attempt is 
indicated by xxxx, which can be one of the 
following. 

OK 

ATTACH PROBLEM 

BUSY 

DEFINE PROBLEM 

The ST parameter was specified without an 
equals sign in a directive to ASDEBUG. 

Output file message indicating that the S/C 
register record was not found in the EDD 
file. 



Informative dayfile message indicating that 
stimulation is complete. 

The SU parameter on the ASUSE control 
statement was not a number from through 16 
or was less than the SL parameter. 

Output file message indicating that the 
requested subsystem was not found in the 
EDD file. 

The SUPIO functin READSR returned error 
code ec when attempting to read record x 
from file filenam. 
ec Error code 

0001 Write parity error; data 
transferred 

0002 Unrecognizable write address; 
data transferred 

0003 Unrecognizable write, detail 
status error; data transferred 

001 1 Buffer full on coded file 
0013 Buffer full on binary file 
0021 Operation complete on coded 

file 
0023 Operation complete on binary 

file 
0031 End-of-file on coded file 
0033 End-of-file on binary file 

0070 Not a SUPIO file 

0071 Duplicate record ID 

0072 Index pointers in FET are 



If xxxx is not OK, MSSSLV 

analyze error and try 

again. Ensure that the 

link device is 

configured as a direct 

access permanent file 

device. 



Specify ST correctly ASDEBUG 

and try again. 

Ensure that the dump file DSDI 
contains meaningful 

information. 

None. STIMULA 



Correct the SU parameter ASUSE 
and retry. 



Ensure that the dump file DSDI 

contains meaningful 

information. 



Analyze error and 
try again. 



NDA 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



unrecognizable 

0073 Index area too small 

0074 Random request on sjequential 
file 

0075 Sequential request on random 
file 

0076 Rewrite longer than previous 
record 

0077 Rewrite on non-existent record 
1031 End-of-information on coded 

file 
1033 End-of-information on binary 
file 

4001 Write parity error; data not 
transferred 

4002 Unrecognizable write address 
error; data not transferred 

4003 Unrecognizable write, detail 
status error; data not 
transferred 

4007 Track limit 



SUPIO ERROR ec IN filenam ON WRITING RECORD 



The SUPIO function WRITESR returned error 
code ec when attempting to read record x 
from file filenam. Refer to SUPIO ERROR 
code IN filenam ON READING RECORD x message 
for error code meanings. 



Analyze error and 
try again. 



NDA 



SUPIO OPEN ERROR ec ON filenam. 



The open on file filenam returned SUPIO 
error code ec. Refer to the SUPIO ERROR ec 
IN filenam ON READING RECORD x message for 
the error code meanings. 



Correct error and 
try again. 



LFG 



SUPIO READ ERROR ec ON filenam. 



The read on file filenam returned SUPIO 
error code ec. Refer to the SUP10 ERROR ec 
IN filenam ON READING RECORD x message for 
the error code meanings. 



Correct error and try 
again. 



LFG 



SUPIO WRITE ERROR ec ON filenam. 



The write on file filenam returned SUPIO 
error code ec Refer to the SUPIO ERROR ec 
IN filenam ON WRITING RECORD x message for 
the error code meanings. 



Correct error and try 
again. 



LFG 



SYNTAX ERROR, ASDEBUG ABORT. 



The ASDEBUG control statement or directive 
is syntactically incorrect. 



Correct the control 
statement or directive 
and retry. 



ASDEBUG 



SYNTAX ERROR - ASLABEL ABORT. 



The ASLABEL control statement or directive 
is syntactically incorrect. 



Correct the control 
statement or directive 
and retry. 



ASLABEL 



MESSAGE 

SYNTAX ERROR IN DIRECTIVE. 

SYSEDIT ARGUMENT ERROR. 

SYSTEM DAYFILE DUMPED. 

SYSTEM EDIT COMPLETE - CHANGE n. 

SYSTEM ERROR. 

SYSTEM FILE ERROR. 

SYSTEM NOT IN ENGR MODE. 

TABLE OVERFLOW. 

TABLE OVERFLOW ON INPUT. 

TAPE ERROR X. GO /X. DROP. 



SIGNIFICANCE 



One of the directives to ASDEBUG is 
syntactically incorrect. 

An error was detected on the SYSEDIT 
control statement. 

The system dayfile dump is complete. 

Informative message indicating the change 
level and completion of SYSEDIT. 

A software or hardware system error 
occurred. 

Informative message indicating that an error 
was detected in the system file. A sub- 
sequent message is issued which indicates 
details about the source of error. 

The system must be in engineering mode when 
the LOADBC control statement is entered. 



Dayfile message indicating that not enough 
storage was available to hold all terminal 
description table entries. 

Dayfile message indicating that too many 
flaw entries were available in the input 
stream; the flaw limit is 157 flaws. 

An error was encountered while QDUMP was 
writing to the dump tape. 



ACTION 


ROUTINE 


Correct the directive 


ASDEBUG 


and try again. 




Correct the error and 


SYSEDIT 


retry. 




None. 


DAYFILE 


None 


SYSEDIT 


Inform site analyst 


MODVAL, 


immediately. 


PFM 


Take appropriate action 


SYSEDIT 


based on the second 




message. 





Enter the ENGR command 
to place the system in 
engineering mode. 
(Refer to the NOS 
Operator's Guide.) 

Rerun with a greater 
field length specified. 



Correct and rerun. 



To continue job, enter 
X.GO. To terminate 
dump, enter X.STOP. 
Mount another tape and 
retry QDUMP. 



LOADBC 



VALNET 



FORMAT 



QDUMP 



TAPE PARITY ERROR. 



TASK PERCENTAGE UNEQUAL TO 100. 



Parity error was encountered while a load, 
catalog, or copy to a file was attempted. 
Tape is skipped to next EOR mark. This is 
a nonfatal system error and is similar 
to the PARITY ERR filenam userin. 
message except that the file name and user 
index are not known. 

K-display message indicating that the total 
task percentages for all tasks defined do 
not add up to 100. 



Try backup tape or 
inform site analyst. 



Correct task definitions 
in the session file. 



PFATC , 

PFCOPY, 

PFLOAD 



STIMULA 



ha 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



TELEX ABORT. 



TELEX NOT ACTIVE. 



Fatal dayfile message indicating that 

the time-sharing subsystem aborted while the 

stimulator was running. 

Fatal dayfile message indicating that 
the time-sharing subsystem is not at a 
control point. 



Examine the dayfile for 
the cause. 



Bring the time- sharing 
subsystem to a control 
point before running 
the stimulator. 



ITS, 
1TE 



ITS, 
1TE 



TERMINAL DESCRIPTION ERRORS. 



Dayfile message indicating that errors were 
found in the terminal description. 



Examine the listing for 
diagnostic messages. 



VALNET 



TERMINAL NAME DUPLICATES THAT OF KTS 
TERMINAL . 



Output file message indicating that a 
terminal name was specified which was the 
same as an already specified TRkNEX 
terminal. 



Correct and rerun. 



VALNET 



TERMINAL NAME TABLE OVERFLOW. 



Output file message indicating that not 
enough storage is available to contain all 
the terminal description table entries. 



Rerun with a greater 
field length specified. 



VALNET 



TERMINAL NAME TOO LONG. 



Output file message indicating that the 
terminal name specified was more than seven 
characters. 



Correct and rerun. 



VALNET 



TIME LIMIT UP. 



Dayfile message indicating that the total 
time limit on the CYCLE, command has passed. 



Input can again be 
accepted by the 
simulator. 



SCRSIM 



TOO MANY BITS SPECIFIED. 



Dayfile message indicating that more bits 
were specified than can be held in the area, 
line, or byte given. 



Correct and reenter. 



SCRSIM 



****T00 MANY CHARACTERS IN VALUE. 



Output file message indicating that the 
value for a directive consists of too many 
characters. 



Rerun using legal value. 



PROFILE 



TOTAL VALIDATION ERRORS = n. 



Informative message indicating that ASVAL 
found n validation errors. 



None. However, n can be 
used as the FX parameter 
on subsequent ASVAL 
runs, if catalog repair 
processing is desired. 



ASVAL 



TRACK ALREADY ASSIGNED. 



The track byte for the IQFT file in the DULL 
word in the MST is already assigned. 



Inform site analyst. 



QFM 



TRACK LIMIT ON SDF DEVICE. 



The device selected to be an RMS deadstart 
device does not have enough space to 
accomodate the deadstart file. 



Use another device. 



US 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



UCP CALL ERROR. 



UNABLE TO ATTACH MRF, FM=family. 



There is an ASVAL or MSSEXEC internal error. 



File MOVCOM could not be attached. 



Submit a Programming 
System Report (PSR) with 
supporting material. 

Purge MOVCOM and rerun 
ASMOVE to create a new 
file. 



ASVAL 



EXDEST 



UNABLE TO CONNECT WITH EXEC. 



UNABLE TO DEFINE filenam. 



UNABLE TO DEFINE COMMUNICATION FILE. 



UNABLE TO OPEN CATALOG. 



UNABLE TO OPEN CSUMAP. 



UNABLE TO READ MRF, FM=family. 



MSSEXEC is not running at this time. 



An error was encountered during an attempt 
to define file filenam under the user's 
family and user index. 



File MOVCOM does not exist and cannot be 
defined by ASMOVE. 



The MSF Catalog does not exist or is busy. 



The CSU map does not exist or is busy. 



A read error was encountered on the move 
request file, MOVCOM. 



Rerun the utility when ASMOVE, 
MSSEXEC is running. ASDEBUG 

Ensure that an indirect ASDEBUG 

access file named 

filenam does not exist 

and that no direct 

access file named 

filenam is in use and 

retry. 

Submit a Programming ASMOVE 

System Report (PSR) with 
supporting material. 

Correct the control ASUSE 

statement or wait until 
the MSF catalog is not 
busy. 

Correct the conrol ASUSE 

statement or wait until 
the CSU map is not busy. 

Purge MOVCOM and rerun EXDEST 

ASMOVE to create a new 

file. 



UNCORRECTABLE RMS ERROR, 



An error was detected when reading the 
EOI. 



Retry operation. 



DFTERM 



UNKNOWN INITIAL STATUS. 



Output file message indicating that the 
initial status specified was neither ON nor 
OFF. 



Correct and rerun. 



VALNET 



UNKNOWN KEYWORD. 



UNKNOWN MULTIPLEXER TYPE. 



Ouput file message indicating that an 
unknown keyword has been entered, or the 
keyword entered was not followed by ■• 

Output file message indicating that an entry 
other than //6671, //6676, //DIAL, or //STIM 
has been entered in the multiplexer 
definition directive. 



Correct and rerun. 



Correct and rerun. 



VALNET 



VALNET 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



m 



UNKNOWN TERMINAL TYPE. 



UNRECOGNIZABLE DIRECTIVE. 



UNRECOGNIZABLE LABEL. 



UNRECOGNIZED CHARACTER FOUND ~x~. 



UNRECOVERABLE ERROR CONDITION OCCURRED. 



UNRECOVERABLE MS ERROR. 



UNRECOVERABLE READ ERROR. 



UNRECOVERABLE WRITE ERROR. 



Output file message indicating that a 
terminal type other than AB, ID, *AB, or 
*ID has been specified. 

Output file message indicating that the 
directive entered was not a valid DSDI input 
directive. 

The cartridge label to be repaired is of 
unknown type. 



The character x is illegal, 
resumes at the next period. 



The scan 



Dayfile message indicating that operation 
was terminated due to a nonrecoverable 
error. 



An irrecoverable mass storage error was 
detected during an I/O operation. 

The cartridge label cannot be read because 
of a faulty MST or cartridge. 



The cartridge label cannot be written 
because of a faulty MST or cartridge. 



Correct and rerun. VALNET 



Correct and rerun. DSDI 



Retry the FX directive ASLABEL 

to ASLABEL without 

specifying the FM 

parameter, or use 

ASDEBUG to read the 

streams from the 

cartridge in order to 

analyze the label. 

The valid characters LFG 

are alphanumerics and 

the delimiters colon, 

comma, semicolon, and 

period. Correct the 

character and try again. 

Refer to the general and FORMAT 

detailed status described 

in the output listing for 

the specific error 

condition. If this 

condition occurs, it is 

extremely probable that 

the pack and/or disk 

drive is unusable in its 

present condition. 

Inform site analyst. QFM 



Retry after cleaning or ASLABEL 

repairing the MST, 

relabel the cartridge, 

or discard the 

cartridge. 

Retry after cleaning or ASLABEL 
repairing the MST, or 
discard the cartridge. 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



UNRECOVERABLE WRITE ERROR. 
DESTAGE RESTARTED. 



A file destage operation was restarted 
using a different cartridge because a write 
error was encountered when the cartridge 
label was being rewritten. 



Inform customer 
engineer . If the 
affected cartridge can 
be identified, remove 
it and try to relabel 
it. Refer to Error 
Conditions and Corrective 
Action in section 3. 



EXDEST 



UNRECOVERED PARITY ERROR - filename 
ENTER K.GO - CONTINUE ON NEW REEL. 
K.END - ABORT DUMP. 
K. DISABLE - CONTINUE ON ONE FILE. 



UPDATE COMPLETE. 



UPDATE NOT ALLOWED BY INQUIRE. 



An irrecoverable parity error was 
encountered on archive tape during PFDUMP 
operations; file is skipped. This is a 
nonfatal system error. The DISABLE option 
is displayed only if both the archive and 
verify files are active. If selected by the 
operator, the dump will continue on the 
remaining good file. 

Dayfile message indicating update run 
successfully completed. 

Entry of update directives is rejected 
during K-display inquire of a user number. 



Described in message • 



PFDUMP 



None. 



Request K-display update 
of user number if update 
is desired. 



MODVAL 



MODVAL 



UPDATE SECURITY OUT OF RANGE. 



UPDATING usernum. 



USER ARGUMENT OUT OF RANGE. 



Output file message indicating that the data 
base update security specified was not in 
the range of to 7 . 

Message displayed at line 1 of control point 
indicating that the user number usernum is 
being updated. 

Output file message indicating that the user 
argument specified was not in the range of 
to 77777777B. 



Correct and rerun. 



None. 



Correct and rerun. 



VALNET 



MODVAL 



VALNET 



USER INDEX NOT ON DEVICE. 



USER INDEX PREVIOUSLY DEFINED. 



O 



Permanent files for the user index currently 
being cataloged do not reside on the device 
being cataloged. ThiB is a fatal system 
error; PFCAT abort. 

More than one user number has been assigned 
to a user index with the UI identifier. 
MODVAL disregards this user number entirely 
unless the CV parameter (suppression of 
automatic creation of system and library 
user indexes) has been selected. In that 
case, the duplication is flagged on the 
output file and processing continues 
normally. 



Retry utility and specify PFCAT 
the correct combination 
of user index and device 
number. 

Rerun the job or correct MODVAL 
the new validation file 
so that only one user 
number is assigned to any 
user index. 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



M 



USER INDEX userin PURGED. 



USER NOT SYSTEM ORIGIN. 



USER NUMBER INVALID. 



Output file message indicating that the 
files under user index userin were purged 
during a REFORMAT run. 

The user who entered the LOADBC control 
statement did not have system origin 
privileges. 

User number cannot be converted to user 
index correctly. 



None. 



Enter the LOADBC 
control statement from 
the console. 

Reenter parameters and 
specify correct user 
number, or site analyst 
must create a new user 
number. 



MODVAL 



LOADBC 



PFS 



USER NUMBER NOT FOUND. 



V, D, XI OPTION VIOLATED. 



VALIDATING SB=sub CSU=id. 



Output file message indicating that an 
attempt was made to delete (or inquire or 
update from the K display) a nonexistent 
user number. If entered from the K display, 
the line of input on which the error 
occurred is disregarded; otherwise, that 
particular user number is disregarded. 

The specified directive to ASDEBUG requires 
only one of the three parameters V, D, or XI 
to be specified. 

Informative message indicating that ASVAL 
is validating the MSF catalog for subfamily 
sub and the CSU map for CSU id. 



Correct input 
directives and rerun 
job, or correct new 
validation file, if 
necessary. 



Correct the directive 
and retry. 

None. 



MODVAL 



ASDEBUG 



ASVAL 



VALINDs READ ERROR. 



Dayfile message indicating that a read 
operation on VALINDs did not complete, 
file must contain a level and level 1 
block. 



Ensure that the file is 
The local and contains a 
level and a level 1 
block (at least one user 
entry) and rerun. 



MODVAL 



VALNET ARGUMENT ERROR. 



VALNET COMPLETE. 



VALUE NEEDED FOR PARAMETER p 



VERIFYING ADDRESSES S/N=serialn. 



Dayfile message indicating that the VALNET 
control statement contains unknown or 
incorrectly used arguments. 

Dayfile message indicating that all 
descriptions have been validated as correct. 

NDA aborted because a value was missing for 
call parameter p. 



Console message indicating that a read-only 
pass is being made across the pack. This 
message is displayed after successfully 
fetching the factory-recorded data and flaw 



Correct and rerun. 



None. 



Supply a value for the 
parameter and call NDA 
again. 

None. 



VALNET 



VALNET 



NDA 



FORMAT 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



maps or after successfully restoring the 
address fields, if the V (verify) option was 
specified on the FORMAT control statement. 
Here, serialn is the actual pack serial 
number read • 



VSN = vsn. 

FAMILY - family. 

SUBFAMILY - sub. 

CSU - id. 

X - x. 

Y - y. 

UNEXPECTED CSU, X, Y, FAMILY OR SUBFAMILY. 



VSN ALREADY IN CSUMAP. 



VSN NOT FOUND. 



VSN NOT FOUND IN CSUMAP. 



VSN OPTION VIOLATED. 



Corresponding fields in the cartridge label 
and CSU map entry do not match. The values 
from the cartridge label are shown in the 
message. 



A cartridge being added from the input 
drawer has a scratch or manufacturer's label 
and a VSN which is already assignd in the 
CSU map. Because all cartridges have unique 
VSNs, the CSU map entry is probably obsolete. 

The vsn specified in the directive to 
ASDEBUG is not contained in the CSU map. 

The vsn specified in the RM directive to 
ASLABEL or in the label of the cartridge 
being restored is not contained in the CSU 
map. 

One of the following. 

- V»vsn cannot be used with the directive 
specified. 

- V>»vsn was not specified but is required 
with the directive specified. 

- V«vsn cannot be used with at least one 
of the other parameters specified. 

- V alone cannot be used with a directive 
to ASDEBUG. 



Remove the cartridge ASLABEL 

from the output drqwer. 

If the cartridge is to 

be restored, correct the 

RS directive and retry. 

If the cartridge is to 

be removed, retry the RM 

directive, specifying 

the lost cartridge (LT) 

option. 

Remove invalid CSU map ASLABEL 
entry, using steps 
described in section 3: 
Removal of Faulty or 
Missing Cartridges. 



Correct the vsn and 
retry. 

Correct the directive 
and retry. 



Correct the error and 
retry. 



ASDEBUG 



ASLABEL 



ASLABEL 
ASDEBUG 



WAIT FOR CATALOG INTERLOCK. 



WAIT FOR PF UTILITY ON xx. 



O 



Informative message indicating that 
permanent file requests are currently 
active. PFDUMP will automatically 
continue when interlock on device is 
successful. 

PFDUMP or PFCAT utility is waiting for a 
permanent file utility (such as PFLOAD or 
MSI) to complete processing on equipment 
xx. The waiting utility continues 
automatically when the other utility 
completes. 



None. 



Wait for utility to 
complete. 



PFDUMP 



PFDUMP 
PFCAT 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



O 



WAITING FOR EXEC. 



MSSEXEC is temporarily delaying the 
processing of ASVAL requests. 



None. 



ASVAL 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



WAITING FOR FILE filenam. 



WAITING - GLOBAL INTERLOCK. 



Informative message indicating that ASVAL is None, 
waiting for MSSEXEC to return a CSU map or 
an MSF catalog. 

Informative message indicating that another None, 
deadstart file installation is in progress 
on the selected device. 



ASVAL 



US 



WORD ADDRESS NOT FOUND. 



WPE UNRECOVERED -ABORT. 



WRITING SUMMARY. 



X,Y OPTION VIOLATED. 



Output file message indicating that a word 
address requested was not found in the 
specified record in the EDD file. 

Operator has aborted PFDUMP operation by 
entering K.END in response to UNRECOVERED 
PARITY ERROR message. This is a fatal 
system error. 

Informative message indicating that summary 
report is being generated. 

An invalid X,Y combination was specified by 
the XI and YI parameters in a directive to 
ASLABEL . 



Ensure that the dump file 
contains meaningful 
information. 

Retry PFDUMP operation 
using a different tape. 



None. 



Correct the XI,YI 
parameters and retry. 



DSD I 



PFDUMP 



PFCAT 



ASLABEL 



XI, YI OPTION VIOLATED. 



IIS - ILLEGAL REQUEST. 



jobnam ABORTED - message. 



One of the following. 

- XI and YI parameters were required but 
were not specified. 

- XI and YI were not specified together. 

- Either the XI or YI parameter was not a 
legal value. 

US was called with an illegal function 
request. 

Unauthorized or incorrect user program 
sent invalid requests to MSSEXEC; message 
can be any of the following. 

- ALREADY CONNECTED 

- CARTRIDGE ACTIVE 

- INVALID ADDRESS 

- INVALID REQUEST CODE 

- INVALID REQUEST TYPE 

- MULTIPLE REQUESTS 

- MULTIPLE RUN 

- NOT CONNECTED 



Correct the XI and/or 
YI parameters and 
retry. 



None. 



Ensure that only 
authorized versions of 
the utilities are used. 



ASDEBUG 



IIS 



EXUCP 



jobnam ABORTED - UTILITY CONFLICT. 



ASVAL, ASLABEL, and ASDEBUG are mutually 
exclusive utilities. 



Rerun the aborted 
utility after the other 
one has terminated. 



EXUCP 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



xxxxxx DAYFILE TERMINATED. 



filenam EQxx TRACKtttt LENGTH ERROR. 



Informative message indicating that dayfile 
xxxxxx has been terminated (issued to system 
and control point dayf lies) . 

Physical EOI of disk and logical EOI of 

TRT are not identical. 

filenam Name of file in error 
xx EST ordinal of device 
tttt First track of file in error 



None. 



Inform site analyst. 



SFM 



QDUMP, 
QMOVE, 
QREC 



nnnn ERRORED FILES CREATED. 



nnnn FILES ACTIVATED DNdn FM family. 



nnnn FILES DEQUEUED DNdn FM family. 



nnnn FILES DUMPED (A) DNdn FM family. 



nnnn FILES DUMPED (I) DNdn FM family. 



Informative message indicating the number None, 
(nnnn) of locked common files created on the 
destination device because of unrecoverable 
write errors which occurred on that device. 
The names of these files are of the form 
ERRxxx, where xxx is a three-digit sequence 
number from 001 through 999. 

Informative message indicating the number None, 
of queued files that have been activated 
on the specified device. 

nnnn Number of files 

dn Device number 

family Family name 

Informative message indicating the number None, 
of files that have been dequeued on the 
specified device. 

nnnn Number of files 

dn Device number 

family Family name 

Informative message Indicating the number None, 
of active queued files which have been 
dumped and remained active on the 
specified device. 

nnnn Number of files 

dn Device number 

family Family Name 

Informative message indicating the number None, 
of inactive queued files which have been 
dumped and remained inactive on the 
specified device. 

nnnn Number of files 

dn Device number 

family Family name 



QMOVE 



QREC, 
QMOVE 



QREC, 
QMOVE 



QDUMP 



QDUMP 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



nnnn FILES IGNORED DNdn FM family. 



M 



nnnn FILES MOVED (A) DNdn FM family. 



nnnn FILES MOVED (I) DNdn FM family. 



nnn FILE(S) PURGED. 



nnnn FILES PURGED DNdn FM family. 



nnn USER INDICES PURGED. 



Informative message indicating the number None, 
of queued files which have been ignored on 
the specified device during a queue 
operation. 

nnnn Number of files 

dn Device number 

family Family name 

Informative message indicating the number None, 
of active queued files that have been 
moved and remained active on the specified 
device. 

nnnn Number of files 

dn Device number 

family Family name 

Informative message indicating the number None, 
of inactive queued files that have been 
moved and remained inactive on the 
specified device. 

nnnn Number of files 

dn Device number 

family Family name 

Informative message indicating that nnn None, 
files were purged according to the last 
access date. 

Informative message indicating the number None, 
of queued files which have been purged 
on the specified device. 

nnnn Number of files 

dn Device number 

family Family name 

Dayfile message indicating that all files None, 
under nnn user indices were purged via the 
reformat option. This can occur only with a 
system origin job. 



QREC, 

QDUMP, 

QMOVE 



QMOVE 



QMOVE 



NDA 



QREC 



MODVAL 



INDEX 



Access word 5-21 
Account dayfile messages 

Format 5-72 

Message groups 

Accounting (A) 5-74 
Description 5-74 
Installation (I) 5-74 
Statistical (S) 5-79 
Usage (U) 5-84 
Accumulators, installation 5-52 
Active dayfiles 2-23 
Active queue files 2-18,34,36 
AFD 2-38 
AIP trace 4-1,8.1 
Allocation unit 3-2 
Alternate directive file 

DSDI 10-8 

Queue utilities 2-6 
Alternate storage address 1-13,35; 3-8 
amsg 1-35 

Answerback 4-16; 5-17,23 
Application bits 5-22 
Application interface program trace 

4-1,8.1 
Application usage accounting 5-38,84,85, 

87,88 
Archive file 

Description 1-1 

Multifile 1-1,4 

Preassignment 1-33 
asa 1-13,35; 3-8 
ASDEBUG 3-2,23,26,37,46,47 
ASDEF 3-1,9,10,40 
ASLABEL 3-1,10,10.1,11,12,13,14, 

40,45 
ASMOVE 3-1,8,17,20,40,43,48 
AST 3-5 
ASTIM 4-14 
AU 3-2 
AUIMX 5-38 
ASUSE 3-2,30 
ASVAL 

Description 3-2,22,41 

Examples 3-29,41,42 

Problem reporting 3-23,26,37,45 

Release processing 3-17,22,26,41 

Validation report 3-3,27,28,46,47 
Auxiliary device 1-17 



Backup requirement 1-11,35,42; 3-8,17 
20,40,43,45 



Basic usage report 3-30,32 

Binary maintenance log 

Dayfile dumping utility 2-38 
DSDI directive 10-19 



Carriage control tape 9-1 
Cartridge 

Allocation to a file 3-5,6,13,30,41 
Assignment 3-1,2,4,8,10,12,13,16 
Availability 3-2,30 
Description 3-1,2 
Label 

Information 3-2,10,12,13,16 

Repairing 3-10,13 

Updating 3-2,12,16 



* v*V3I 
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Removal of 3-46 

Residence in CSU 3-3 

Restoration 3-10,13,46 

Stream 3-2 
Cartridge storage unit 

Assignment to subfamily 3-10,12,40 

CSU identifier 3-1,10,14,23,31,38 

CSU map 3-3 

Description 3-1 

Pool 3-3,12 

Reserved area 3-3,12 
Catalog entry 1-9 
Catalog image record 

Description 1-43 

PF utility option 1-30 
Catalog track 

Description 1-7 

Entry 1-9 

Number of 1-7 
Central memory space 5-20 
Chain of streams 3-2,7,8,25,26,27,47 
Character set, terminal 5-26 
CHARGE control statement 

Batch usage 5-61 

Description 5-59 

Terminal usage 5-61 
Charge number 5-26,39,49,53,61 
Checkpoint, multi mainframe 8-8 
CIR (refer to catalog image record) 
COMSSRU 5-64 
Coupler 3-1 

CSU (refer to Cartridge storage unit) 
CSU identifier 3-1,10,14,23,31,38 
CSU map 

Analysis 3-2,25 
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Index-1 



Backup 3-4,16,38,39,44 
Creating 3-1,9,40,43 
Description 3-3 
Ordinal 3-3 

Updating 3-4,12,13,16,36,43 
Cubicle 

Allocation 3-1,3,4,10,12,30 
Availability 3-2,30 
Description 3-1 



DAT 8-1,4 

Day file dumping utilities 2-38 

Dayfile messages A-l 

Dayfile termination 2-23 

Deadstart dump interpreter (refer to DSDI) 

Deadstart sequencing 7-3 

DEMUX control statement 4-30 

Destage 3-2,8,17,20,21,30,40,41 

Device access table 8-1,4 

Device mask 1-3 

DFD 2-38 

DFLIST 2-25 (refer also to queue file 

utilities) 
DFTERM 2-23 (refer also to queue file 

utilities) 
Diagnostics A-l 
Disk space 

Management 3-8,17,21,40 

Release 3-2,8,17,20,21,40 
DPFC macro 9-2 
DSDI 

Control statement 10-3 

Description 10-1 

Directive format 10-6 

Dump tape request 10-4 

Examples 

Batch 10-32 
Interactive 10-29 

Input directives 10-5,25 

Interactive use 10-24 

Parameters 10-3 
Dump 

Full 1-42; 3-42 

Incremental 1-41; 3-43 

Partial 1-42 
Dump tape management 3-21,43 



ECS space 5-20 
EDD 10-1 
ELD 2-38 
EOC 3-2,25,27,47 
Error messages A-l 

Express deadstart dump interpreter (refer 
to DSDI) 



Family 1-17 

FAMILY control statement 1-17 

Fast-attach files 7-1 

FCT 3-5,38 

FCT ordinal 3-3,4,35 

File label verification procedure 3-9 

Flaw data, disk pack 13-1 

FNTLIST 2-36 (refer also to queue 

file utilities) 
FORMAT (refer to pack reformatting, 

881/883) 
Forms code 2-11 
Fragment 3-7,25,26,27,33,47 
Frozen chain 3-7,26,33,38 



GENVAL 7-4 



HOC 3-2,25,26,27,47 

Holding registers (refer to SCRSIM) 



IAFEX 4-8.1 

IAFTM 4-8.1 

IAFTR 4-8.2 

Inactive day files 2-23 

Inactive queue files 2-18,25 

Index, user 1-3 

Initializing and releasing fast -attach 

files 7-3 
Intersections 3-25,28,47 
INSTALL 12-1 
ISF 7-1 



Label, cartridge 

Description 3-2 

File label verification procedure 3-9 

Repairing 3-2,10,13 

Stream label verification procedure 
3-2 

Updating 3-2,12,13,16 
Label track 1-14 
LCFFILE 4-9 
LDLIST 2-34 (refer also to queue file 

utilities) 
LFG (refer to load file generator) 
LIBRARY user number 5-38 
Limit registers, installation 5-52 
Link device 8-2 
Linkage byte 1-14,16 
Load (refer also to PFLOAD or QLOAD) 

Incremental 1-43 

Noninitial 1-30 
Load file generator 

Description 4-1 



Index-2 



60455380 G 



Example, LFG 4-3 

Examples, file description 
statements 4-2 

Execution 4-3 

File description statements 4-1 

Load modules 4-1,3 

NDL parameter agreement 4-1 
Local configuration file 4-9 
Looping chain 3-25 
Lost cartridge 3-6,12,14,26,31,33 



Machine identifier 8-2,3 
Machine mask 8-3 
Machine recovery table 8-1,6 
MAINLOG 2-38; 10-19 
Mask 

Device 1-3 

Machine 8-3 

Secondary 1-5 

Track 1-8 
Mass storage 

Shared 8-4 (refer also to shared 
mass storage) 
Mass Storage Facility 

Description 3-1 

Files on 3-8,17,22 

MSF catalog 3-4 
Mass Storage Subsystem 

Description 3-1 

Files 3-1,9,22 

Initialization 3-40 

Utilities 3-1,9 
Mass storage table 

Description 1-7 

Dumping (DSDI) 10-18 

Report (PFCAT) 1-37,38 
Master device 

Definition 1-3 

Dumping 1-27 

Number of catalog tracks 1-8 

User index relationship 1-3 
Master user 5-40,49 
MID 8-2,3 
MODVAL 

Batch input 5-11 

Console input 5-5 

Control statement 5-12 

Description 5-5 

Examples 5-26 

Input directives 5-16 

Special user numbers 5-38 
MREC 8-3 
MRT 8-1,6 



MSA 3-1 

MSF (refer to Mass Storage Facility) 

MSF catalog 

r\XlctJ.vSlS «5~ It j & O j It D 

Backup 3-8,16,44 

Chain of AUs 3-2 

Creating 3-1,9,40,44 

Description 3-4 

Ordinal 3-4 

Subcatalog 3-5 

Updating 3-8,12,13,16,22,38 
MSS (refer to Mass Storage Subsystem) 
MSS processing 

Backup and recovery 3-42 

Disk space management 3-8,17,21,40 

Error conditions 3-2,45 

Initialization 3-1,9,40 

MSF space management 3-40,41 

Multimainframe environment 3-9,30; 
8-1,8 

Pseudo release 1-12; 3-18,48 

Utilities 3-1,9 
MSSEXEC 3-9,16,17,22,41 

TLKC\C*C\T IT n e\ 

IVIOOOIj V 0-3 

MST 3-1,7 
Multimainframe operation 

Deadstart 8-2,4 

Description/Overview 8-1 

MSF environment 8-1,8 

Shared mass storage 8-2,4 
Multiplexer definition directive 4-10 
Multipliers 5-51,65,70 



NCFFILE 4-9 

NCTFid 4-9,11 

NDA (refer to NPU dump analyzer) 

NETWid 4-9 

Network configuration file 

Description 4-9 

Directives 4-10 

Names 4-9 
Network dump files (refer to NPU dump 

analyzer) 
Network description files 4-9,12 
Network products stimulator 4-15 
Network utilities 4-1 (refer also to 

individual utilities) 
NPS 4-15 
NPU dump analyzer 

Control statement 4-5 

Description 4-5 

Network dump files 4-7 

Report formats 4-6 
NSTIM 4-15 
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Obsolete file 1-13; 3-9 

Off -cartridge link (Off-MSC link) 

3-7,32,33,35 
Ordinal 

CSV map 3-3 

FCT 3-3,4 

MSF catalog 3-3,4 
Orphan file 3-5,9,22,26,27 



Pack reformatting, 881/883 
Control directives 13-4 
Data statements 13-4 
Examples 13-5 

FORMAT control statement 13-2 
Input format 13-3 
Output format 13-5 
Special access procedures 13-9 
Parity, terminal 5-25 
Password 5-13,17 
Permanent file access 5-24 
Permanent file catalog 1-9 
Permanent file utilities 
Calling 

Batch 1-25 
Console 1-20 
Terminal 1-25 
Example 1-45,46 
Overview 1-1 
Parameters 1-25,27 
Routines 1-34 (refer also to 
individual routine name) 
PFATC 1-37 (refer also to permanent 

file utilities) 
PFC (refer to programmable format control 

or permanent file catalog) 
PFC AT 1-37 (refer also to permanent 

file utilities) 
PFCOPY 1-41 (refer also to permanent 

file utilities) 
PFDUMP (refer also to permanent file 
utilities) 

Description 1-41 
Example 1-46 
PFLOAD (refer also to permanent file 
utilities) 

Description 1-42 
Example 1-45,46 
Execution 

Archive file check 1-44 
Device check 1-46 
Specified option check 1-45 
Plot units 5-19,85,86 
Pool 3-3,12 

Preferred residence 1-11,35; 3-17,19,20 
Preserved file, TRT bits 1-15 
PRESET (ECS) 8-2,3 



PROBE 15-1,29 
PROFILa 5-1,40,42 
PROFILE 

Access 5-40 
Batch input 5-55 
Console input 5-54 
Control statement 5-40 
Input directives 5-49 
Parameters, control statement 5-40 
Terminal input 5-55 
Programmable format control 
Arrays 

Adding 9-2 
Building 9-1 
Description 9-1 
Released 9-3 
Rules 9-1 
Description 9-1 
Project number 5-26,39,52,53 
Pseudo release 1-12; 3-18,48 



QALTER 2-34 
QDUMP 2-26 
QFSP 2-2 
QLIST 2-25 
QLOAD 2-28 
QMOVE 2-30 
QREC 2-18 
Queue file utilities 

Alternate input file 2-7 

Calling 

Batch 2-7 
Console 2-2 
Terminal 2-8 

Commands 2-4 

File preassignment 2-17 

Overview 2-1 

Parameters 2-8 

Routines 2-18 (refer also to 
individual routine name) 
Queue file supervisor 2-2 



Record types 6-7 

Release data file 1-31; 3-22,23,41, 

42,43 
Release space 

Disk 3-2,8,17,20,21,40 

MSF 3-2,9,17,22 
Reserved area of CSU 3-3,12 
Resource accounting 5-62 
Resources controlled by MODVAL 5-4 
RSXDid 7-1,3 
RSXVid 7-1,3 
Rubout count 5-25 
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Scattered file 3-24,25 
Scratch cartridge 3-2,13 
Script file 4-13,15 
SCRSIM 

Calling format 11-2 
CYBER 70 use 11-1 
Commands 11-5 
Description 11-1 
| SECDED 10-20 
Secondary mask 1-5 
Security count 5-17 
Session file 4-13,15 
SFS 5-2 

Shared mass storage 
Assignment 8-4 
Checkpoint 8-8 
Description 8-4 
Initialization 8-6 
Recovery 8-7 
Unloading 8-7 
SIMFid 4-9 
Slave 3-9; 8-1,8 

Special accounting privileges 5-22,40 
Special user index 1-6 
Special user numbers 5-38 
SRU (refer to system resource units) 
Stage 1-30; 3-9,37,40,42,43 
Status/control register stimulator 11-1 

(refer also to SCRSIM) 
STIMULA 4-14 
Stimulation 

Description 4-13 
Execution 4-13 
Multiple sessions 4-28 
Output evaluation 4-33 
Parameters 

Mixed mode 4-27 
Output format 4-28 
Session file 4-23 
Stimulator 4-24 
Postprocessing 4-30 
Procedure files 4-32 
Session files 

Description 4-13,15 
Dynamic login 4-16 
Optional think time 
specification 4-21 
Processing 4-22 
Source line input 4-20 
Task definitions 4-22 
STMffff 4-23,32 
Stream 

Conflict flag 3-7,9,33 
Description 3-2 
Detail information 3-7,31 
Label verification procedure 3-2 
Reading 3-37 
Subcatalog 3-4 
Subfamily 1-3; 3-4,9; 5-38 



Subsystem, initial 5-26 
SYSEDIT 

Control statement 6-1 

Description 6-1 

Input directives 6-2 

Record types 6-7 
System file initialization 7-1 
System resource units 

Description 5-2,62 

Example of calculation 5-68 

Formula 5-62 

IO increments 5-68 

Limitation, MODVAL 5-20 

Parameters 5-64 
System user number 5-38 
SYSTEMX user number 5-38 



Task 4-22 

Terminal definition directive 4-10 

Terminal types 5-25 

Test mode 3-18.48 

TRACER 15-1,29 

Track mask 1-8 

Track, mass storage 
Flawed 1-15; 13-1 
Interlock bit (TRT) 1-14,15 
Reservation bit (TRT) 1-14,15 

Track reservation table 1-14; 13-1 



User accounting 5-1,39 
User index 

Assignment (MODVAL) 5-17,24 

Permanent file device assignment 1-3 

Special 1-6 
User numbers 

Description 5-1 

LIBRARY 5-38 

Relationship to charge numbers 5-61 

Special 5-38 

SYSTEMX 5-38 

Use with PROFILE 5-40 
User validation 5-2 
Utilities 

Dayfile dumping 2-38 

MSS 3-1,9 

Network 4-1 

Permanent file 1-1,34 

Queue file 2-1,18 

System data gathering 15-1,29 
Utility map (disk pack) 13-1 
Validation report 3-27,28 
VALIDUs 5-1,2 
VALINDs 5-1 
VALNET 4-12 
Verify file 1-32 
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X, Y coordinates 3-3 881/883 pack reformatting (refer to pack 

reformatting, 881/883) 
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